post
https://sandbox-api-gtw.softpoint.io/api/locations//transactions/transfer
Use this endpoint to send money from your account to an external bank account through the ACH network.
Common use cases include vendor payments, supplier payouts, customer refunds, and partner disbursements.
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer YOUR_ACCESS_TOKEN |
| Content-Type | Yes | application/json |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
location_id | string | Yes | Identifier of the location where the ACH transaction will be processed. |
Request Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
token | string | Yes | Token representing the ACH payment method. |
user_id | string | Yes | Identifier of the user performing the transaction. |
invoice_no | string | No | Invoice reference associated with the transfer. |
amount | number | Yes | Transaction amount to be processed. |
Response
200 — Success
{
"amount_approved": "11.52",
"transaction_id": "3FD911F0-B6D6-0FD4-B41B-D05099D6021D",
"token": "GqirBOPpHTMs9021"
}| Field | Type | Description |
|---|---|---|
amount_approved | string | The amount that was approved for the transaction. |
transaction_id | string | Unique identifier of the created transaction. |
token | string | The ACH token used in the transaction. |
403 — Forbidden
Returned when neither the payer nor the payee has a Merchant ID (MID).
{
"error": {
"code": 99184,
"name": "ach_403",
"message": "Forbidden",
"details": {
"status": false,
"message": "To initiate a transaction, either the payer or the payee must have a mid.",
"data": null,
"errors": null,
"error_code": null
}
}
}