Frequently Asked Questions (FAQ)
Q: What happens if I close the browser during payment?
A: If you've completed KYC, you can return to the link and proceed directly to payment. If payment was in progress, check with your bank or payment gateway.
Q: Is my payment information stored?
A: Payment details are processed securely through payment gateways. WePay doesn't store your full card details.
Contract Fees
Q: Can I set a different fee for each contract?
A: Yes, if contract-level fee is enabled for your account. By default, the fee agreed with WePay for your account applies to every contract. Contact WePay to have contract-level fee enabled. See Contract Fees.
Q: Why am I getting a 403 with error code 1887?
A: You sent a fee field on a contract, but contract-level fee is not enabled for your account. Either remove the fee fields, or contact WePay to enable the feature.
Q: contract-level fee is enabled, but my request fails with BuyerOrSellerFeeRequired. Why?
A: Once contract-level fee is enabled, WePay expects you to state the fee on every contract and does not fall back to your agreed fee. Send buyerFeePercentage and/or sellerFeePercentage, or send noFeesApplied: true if you intend to charge nothing on that contract.
Q: Does noFeesApplied make the contract completely free?
A: It removes your platform fee, so your buyer and seller are charged nothing by you. Your own agreement with WePay applies to the contract as normal. If you're planning a campaign and want to review the details for your account, your WePay account manager can walk you through it.
Q: When is a seller fee collected?
A: At release, not at payment. The buyer pays the contract amount as usual, and your fee is deducted from the seller's payout when the contract is released. A funded contract does not yet mean a seller fee has been collected.
Q: My fee came out different to the percentage I sent. Why?
A: If your agreement with WePay includes a minimum or maximum fee amount, those limits still apply to fees you set per contract. Always read the externalPlatformFee amount from the response rather than calculating it yourself.
Bank Transfer
Q: How do I know when a bank transfer has actually been paid?
A: Wait for the payment.completed or milestone.payment.completed webhook. The earlier bank_transfer.buyer_acknowledged event only means the buyer told the checkout page they sent the transfer, and is not proof that funds arrived.
Q: How long does a bank transfer take to confirm?
A: It depends on the buyer's bank. Unlike online payment, it is not immediate.
Q: Can I choose which payment methods my buyers see?
A: Payment methods are configured by WePay for each platform. Contact WePay if you would like online payment or bank transfer enabled or disabled for your account.
Q: What happens if the buyer transfers the wrong amount?
A: You receive contract.payment.underpaid or contract.payment.overpaid with the expected and received amounts.
The contract/milestone stays unpaid, a refund request is created for the amount received, and it is cancelled (refund_request.cancelled) once the buyer pays the remaining balance.