Skip to main content
POST
/
v1
/
api
/
payment
/
initiate
Initiate Payment
curl --request POST \
  --url https://secureapi.tender.cash/v1/api/payment/initiate \
  --header 'Content-Type: <content-type>' \
  --header 'authorization: <api-key>' \
  --header 'x-access-id: <x-access-id>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-timestamp: <x-timestamp>' \
  --data '
{
  "agentId": "6538eaaebdec6d1a21978e6a",
  "amount": "10.00",
  "chain": "ethereum",
  "coin": "usdc",
  "reference": "ORDER-12345"
}
'
{
  "status": "<string>",
  "message": "<string>",
  "data": {
    "type": "<string>",
    "chain": "<string>",
    "chainId": "<string>",
    "amount": "<string>",
    "agentId": "<string>",
    "merchantId": "<string>",
    "usdAmount": "<string>",
    "coinAmount": "<string>",
    "fee": 123,
    "feeUSD": 123,
    "feeSent": true,
    "rate": 123,
    "walletAddress": "<string>",
    "walletAddressIndex": 123,
    "currency": "<string>",
    "activationFee": 123,
    "activationFeeUSD": 123,
    "contractAddress": "<string>",
    "agentAmount": "<string>",
    "agentRate": "<string>",
    "agentCurrency": "<string>",
    "txId": "<string>"
  }
}

Headers

authorization
string
required
Base64-encoded HMAC-SHA256 signature of the request payload using the API secretMinimum string length: 1Example: "5e73d044c44d733fcf819ad3409aaaddca840d421b69cb0b04e2c750fc62e-ce7526d36296237663ad1f06f62a730c0466516507196b3ce6567493c-c52a7cf63d"
x-timestamp
string
required
Current timestamp in ISO 8601 formatExample: "2025-03-15T09:45:53.000Z"
x-request-id
string
required
Unique identifier for the request (UUID v4)Example: "550e8400-e29b-41d4-a716-446655440000"
x-access-id
string
required
Your API access ID provided by TenderExample: "your-access-id-here"
Content-Type
string
required
Media type of the request bodyExample: "application/json"

Body

agentId
string
required
Agent ID to receive the paymentExample: "6538eaaebdec6d1a21978e6a"
amount
string
required
Payment amount in the specified currencyExample: "1.023"
chain
string
required
Blockchain network to use for the transactionExample: "avalanche"
coin
string
required
Cryptocurrency coin for the paymentExample: "avalanche"
reference
string
Optional reference or transaction ID for your own tracking purposesExample: "ORDER-12345"

Response

status
string
required
Status of the API requestExample: "success"
message
string
required
Human-readable message describing the resultExample: "success"
data
object
required
The initiated payment transaction details (uses formatTransactionResponse structure)

Authorizations

authorization
string
header
required

HMAC-SHA256 signature. Required headers: x-access-id, x-request-id (UUID), x-timestamp (ISO), authorization (HMAC signature)

Headers

authorization
string
required

Base64-encoded HMAC-SHA256 signature of the request payload using the API secret

x-timestamp
string<date-time>
required

Current timestamp in ISO 8601 format

x-request-id
string<uuid>
required

Unique identifier for the request (UUID v4)

x-access-id
string
required

Your API access ID provided by Tender

Content-Type
string
required

Media type of the request body

Body

application/json
agentId
string
required

Agent ID to receive payment

Example:

"6538eaaebdec6d1a21978e6a"

amount
string
required

Payment amount

Example:

"1.023"

chain
string
required

Blockchain network

Example:

"avalanche"

coin
string
required

Cryptocurrency coin

Example:

"avalanche"

reference
string

Optional reference or transaction ID for your own tracking purposes

Example:

"ORDER-12345"

Response

200 - application/json

Payment initiated successfully

status
string
message
string
data
object