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 processed with funding instructions return meaningful data.
Response Data: The response includes funding allocation details, such as account IDs, allocated amounts, 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 server error occurred. |
Important Considerations
Data Security: Handle funding instructions securely to protect sensitive financial information.
Reconciliation: Use funding instructions to reconcile payouts and ensure funds are distributed accurately.
Compliance: Comply with any financial regulations governing fund allocations and transfers.