Skip to main content
POST
/
sender
/
orders
Initiate payment order
curl --request POST \
  --url https://api.paycrest.io/v1/sender/orders \
  --header 'API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "token": "<string>",
  "rate": 123,
  "recipient": {
    "institution": "<string>",
    "accountIdentifier": "<string>",
    "accountName": "<string>",
    "memo": "<string>",
    "providerId": "<string>",
    "metadata": {},
    "currency": "<string>"
  },
  "reference": "<string>",
  "returnAddress": "<string>"
}
'
{
  "status": "success",
  "message": "Operation successful",
  "data": {
    "id": "<string>",
    "amount": "<string>",
    "token": "<string>",
    "receiveAddress": "<string>",
    "validUntil": "2023-11-07T05:31:56Z",
    "senderFee": "<string>",
    "transactionFee": "<string>",
    "reference": "<string>",
    "orderType": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.paycrest.io/llms.txt

Use this file to discover all available pages before exploring further.

Initiate a new order as a sender.

Authorizations

​
API-Key
string
header
required

Body

application/json
​
amount
number
required
​
token
string
required

Token symbol (USDT, USDC, cNGN). See Supported Stablecoins for available options.

​
rate
number
required
​
network
enum<string>
required

Network identifier for the blockchain

Available options:
ethereum,
base,
bnb-smart-chain,
lisk,
scroll,
celo,
arbitrum-one,
polygon,
asset-chain
​
recipient
object
required
​
reference
string
​
returnAddress
string

Response

Payment order initiated

​
status
string
Example:

"success"

​
message
string
Example:

"Operation successful"

​
data
object

The actual response data (e.g., ReceiveAddressResponse, etc.)