Create Transfer

Transfers funds between a merchant's terminals. Both terminals must belong to the same merchant.

Endpoint

POST /v1/transfers

Request Parameters

Parameter	Type	Required	Description
from_terminal_id	string	Yes	Source terminal ID
to_terminal_id	string	Yes	Destination terminal ID
amount	number	Yes	Transfer amount in USDT

Request Example

curl -X POST https://api.bopay.io/v1/transfers \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature" \
  -d '{
    "from_terminal_id": "550e8400-e29b-41d4-a716-446655440000",
    "to_terminal_id": "660f9500-f30c-52e5-b827-557766551111",
    "amount": 500
  }'

Response

{
  "success": true,
  "from_terminal_id": "550e8400-e29b-41d4-a716-446655440000",
  "to_terminal_id": "660f9500-f30c-52e5-b827-557766551111",
  "amount": 500,
  "currency": "USDT"
}

Errors

Code	HTTP	Description
TRF_001	400	Invalid parameters
TRF_002	404	Terminal not found
TRF_003	400	Insufficient funds on the source terminal

info

The transfer is performed atomically — funds are debited from one terminal and credited to the other in a single transaction. No fee is charged.