Refund a split funded transaction
How you refund a split funded transaction depends on whether you want to do a full refund or a partial refund.
Full refunds
Full refunds of a split transaction work the same as refunds for a transaction without splits. Payabli returns the total of the transaction, less any pass-through fees, to the payor, reversing the original transaction’s split instructions. For example, a $103 transaction had a $100 total, plus a $3 pass-through fee. Payabli returns $100 to the payor, removing the funds from the same accounts the funds were originally split into.
To run a full refund, see the refund guide for help.
A request to this endpoint refunds the transaction based on the original transaction’s split instructions.
Partial refunds
Payabli accepts partial refunds when the original transaction was split only if the refund request includes split instructions. You must specify how much to return to the customer, and from whom.
Partial refund considerations
- You can only make refunds from the accounts and entrypoints used in the original request.
- You don’t have to include every account on the original transaction in a partial refund request.
- An account can’t refund more than it received in the original transaction. For example, if Account A received $35 in the original transaction, you will get an error if you try to refund more than $35 from Account A.
- The split amounts are validated for partial refunds. They can’t total more than the original transaction, or the refund request fails.
Example: Partial refund from all accounts on a split
For example, a $103 transaction had a $100 total plus a $3 pass-through fee. The $100 total was split three ways:
- Account A received $50
- Account B received $30
- Account C received $20
A partial refund request comes with split instructions that request $20 from Account A , $10 from Account B , and $5 from Account C. Payabli takes the designated amount back from those recipients and returns a total of $35 to the Payor.
Accounts A, B, and C retain the balance from the original transaction:
- Account A keeps $50 - $20 = $30
- Account B keeps $30 - $10 = $20
- Account C keeps $20 - $5 = $15.
Example: Partial refund from some of the accounts on a split
For example, a $103 transaction had a $100 total plus a $3 pass-through fee. The $100 total was split three ways:
- Account A received $50
- Account B received $30
- Account C received $20
A partial refund request comes with split instructions that request $20 from Account A and $10 from Account B. Payabli takes the designated amount back from those recipients and returns a total of $30 to the Payor.
Accounts A, B, and C retain the balance from the original transaction:
- Account A keeps $50 - $20 = $30
- Account B keeps $30 - $10 = $20
- Account C keeps $20 - $0 = $20.
Split refund examples
To refund a split-funded transaction, send a POST request to the v2 refund endpoint and include split instructions in the refundDetails.splitRefunding array of the request body. See the API reference for full information.
The Refund endpoint has a required path parameter, transId, which is the referenceId for the transaction.
The referenceId identifying the transaction (PaymentId). You can find this in the success response for the payment you want to refund.
For a full refund, use the Refund endpoint and pass the refund amount and split instructions in the request body. For a partial refund, use the Partial refund endpoint and pass the amount in the path with the split breakdown in the body.
This example fully refunds the $100 transaction with a referenceId of 10-3ffa27df-b171-44e0-b251-e95fbfc7a723, passing the amount and split instructions in the request body.
This example refunds a partial amount of $70 (out of $100) of the transaction with a referenceId of 10-3ffa27df-b171-44e0-b251-e95fbfc7a723, using the partial refund endpoint with the amount in the path.
A successful refund returns a 201 status with a JSON body.
Related resources
See these related resources to help you get the most out of Payabli.
References
- Pay In schemas - Learn about Pay In (money in) transaction schemas
- Pay In statuses - Learn about Pay In (money in) statuses