post
https://sandbox-api-gtw.softpoint.io/api/locations//transactions/transfer-in
Use this endpoint to receive money into your account from external bank accounts through the ACH network.
Common use cases include customer payments for goods or services, direct deposits, vendor refunds, and partner transfers.
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": "1500.00",
"transaction_id": "9CBA11F1-C4F6-D76F-B404-0200172B11F8",
"token": "wkpBRUkTAXMy8148"
}| 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
}
}
}
