Fetch the funding instructions provided at the time of the transaction, specifically for transactions involving split funding.
The Get a Transaction's Funding Instructions endpoint allows you to fetch the funding instructions provided at the time of the transaction, specifically for transactions involving Split Funding. This includes details on how the transaction's funds are allocated to multiple bank accounts.
Key Features
- Retrieve funding allocations for a transaction.
- Understand how funds are distributed among multiple accounts.
- Access Split Funding details for auditing and reconciliation.
Usage Notes
Feature Enrollment: Ensure that your merchant account is enrolled in the Split Funding feature.
Valid Transaction ID: Only transactions that were processed with funding instructions will return meaningful data.
Response Data: The response includes funding allocation details such as account IDs, amounts allocated, and any associated metadata.
Response Structure
| Code | Response | Reason |
|---|---|---|
| 200 | Success | Returns an object containing the funding instructions: allocations (array), total_amount, transaction_id |
| 400 | Bad Request | Invalid transaction ID format. |
| 401 | Unauthorized | Authentication failed. |
| 403 | Forbidden | Split Funding feature not enabled. |
| 404 | Not Found | Transaction ID does not exist or has no funding instructions. |
| 500 | Internal Server Error | An unexpected error occurred on the server. |
Important Considerations
Data Security: Handle funding instructions securely to protect sensitive financial information.
Reconciliation: Use funding instructions to reconcile payouts and ensure accurate distribution of funds.
Compliance: Ensure compliance with any financial regulations regarding fund allocations and transfers.