Developer Docs
WebsiteDashboard
GuidesAPI ReferenceHelp
PaymentTransfer

Intra-bank transfer

POST
/openapi/v1/payments/transfer/intra-bank

Intra-bank transfer between accounts. All currencies are supported. Use it to move funds between different accounts within the same bank.

Notes

  • remarks supports only alphanumeric characters, spaces, and the special characters / - ? : ( ) . , ' +
  • If the PROCESSING status is returned, wait 5 minutes and then call the result query endpoint to confirm the final status
  • For orders paid out via POBO, the response returns poboAccountNo / poboAccountName. When you call the result query endpoint, we recommend passing accountNumber=poboAccountNo to explicitly specify the POBO payout account. If accountNumber is not passed, the system automatically matches the corresponding POBO payout account based on referenceNo.

Authorization

bearerAuth
headerAuthorizationBearer <token>

The access_token obtained from POST /oauth2/token. Header format: Authorization: Bearer {accessToken}.

Header Parameters

X-Channel-Provider*string

Provider identifier, such as GLDB

Idempotency-Key*string

Unique request identifier used to prevent duplicate operations (UUID recommended). Valid for 24 hours. Each transfer must use a unique key. Never reuse the same key for different transactions. A resubmission with the same key within the validity period is rejected. For the rules, see the Payment product guide

Request Body

application/json
  1. body
referenceNo*string

Request reference number, the unique request identifier. Length 32

fromAccount*string

Payer account number, the debit account. Length 16

fromAccountName?string

Payer name. Length 128

beneficiaryAccount*string

Beneficiary account number, the credit account. Length 16

beneficiaryAccountName?string

Beneficiary name. Length 128

currency*string

ISO 4217 currency code. Length 3

amount*string

Transaction amount. Length 18

remarks?string

Remarks. Length 140. Supports only alphanumeric characters, spaces, and the special characters / - ? : ( ) . , ' +

autoUsePobo?boolean

POBO payout. true: pay out from the linked POBO account; false or not passed: pay out from fromAccount

Response Body

Returns the transfer acceptance result.

application/json
  1. response
code?integer

Business status code

message?string
traceId?string

Request trace ID. Provide it when you contact technical support

data?

Base fields of business data. The data object of every business response contains these fields (except fee estimation).

Example Request
curl -X POST 'https://api.test.stabofx.com/openapi/v1/payments/transfer/intra-bank' \  -H 'X-Channel-Provider: GLDB' \  -H 'Idempotency-Key: 7f3c2c0e-5b1a-4f6e-9d2a-0a1b2c3d4e5f' \  -H 'Content-Type: application/json' \  -d '{  "referenceNo": "STABO20231121001",  "fromAccount": "10000000001",  "beneficiaryAccount": "10000000002",  "currency": "SGD",  "amount": "200.00",  "remarks": "Payment for services"}'
Example Response
{  "code": 200,  "message": "OK",  "traceId": "a1b2c3d4-e5f6-7890",  "data": {    "providerStatusCode": "000000",    "providerMessage": "ok",    "providerRequestSerialNo": "795883203712778240",    "providerResponseSerialNo": "785957885476737024",    "providerTimestamp": "2023-05-17 21:03:48",    "channelSerialNo": "742465990302056448",    "status": "SUCCESS",    "coreSerialNo": "FT23131QQQ2P",    "poboAccountNo": "10000000003",    "poboAccountName": "EXAMPLE PTE. LTD."  }}

Query balance GET

Query the available balance of an account.

Query intra-bank transfer result GET

Query the result status of an intra-bank transfer. If the transfer returns the `PROCESSING` status, call this endpoint to confirm the final status.