Skip to main content
POST
/
tx
/
createTransferRequest
Create Transfer Request
curl --request POST \
  --url https://api.stablepay.ai/tx/createTransferRequest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipient": "<string>",
  "amount": 1.01,
  "currency": "USDC",
  "issuer": "Valr",
  "acquirerMerchantName": "<string>",
  "reference": "<string>",
  "customReference": "<string>",
  "merchantCategoryCode": "<string>"
}'
{
  "link": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer scheme. Format: Bearer {STA_xxxx}

Body

application/json

Create a new Transfer on Stablepay.

​
recipient
string
required

The recipient Stablepay wallet address.

Minimum length: 1
​
amount
number
required

The total requested amount in USDC or ZAR.

Required range: x >= 0.01Must be a multiple of 0.01
​
issuer
enum<string>
required

The wallet provider to handle the transaction.

Available options:
Valr,
Luno,
Binance,
Bybit,
Chipper
​
acquirerMerchantName
string
required

The acquirer and merchant name requesting this transaction. Format: acquirer-merchant.

Minimum length: 1
​
reference
string
required

A unique reference used to query the transaction status using Get Payment Status API.

Minimum length: 11
​
currency
enum<string>

Available options: USDC, ZAR. Default is (USDC).

Available options:
USDC,
ZAR
​
customReference
string

Optional merchant acquirer custom reference e.g RF-25364.

Maximum length: 100
​
merchantCategoryCode
string

Optional merchant category code.

Maximum length: 10

Response

Transfer request created successfully

​
link
string<uri>
required

Issuer Deeplink to facilitate the transaction.