Create transfer order

POST/api/v1/transfer/command/createHMAC

Initiates a wallet-to-wallet transfer. The order is processed asynchronously and returns with PENDING status.

Headers

Name	Type	Required	Description
X-Api-Key	string	Yes	API key identifier
X-Signature	string	Yes	HMAC-SHA256 signature
X-Timestamp	string	Yes	Unix timestamp in seconds
X-Nonce	string	Yes	Unique request identifier (UUID)

Request Body

Name	Type	Required	Description
idempotentKey	string	Yes	Client-provided idempotency key, unique per transfer
fromWalletId	string	Yes	Source wallet business ID
toWalletId	string	Yes	Target wallet business ID
currency	string	Yes	ISO currency code
amount	number	Yes	Transaction amount in major currency units
remark	string	Yes	Optional remark or memo for the transfer

Request Example

curl -X POST https://api.elaypay.app/api/v1/transfer/command/create \
  -H "X-Api-Key: sk_live_xxx" \
  -H "X-Signature: <computed_signature>" \
  -H "X-Timestamp: 1709337600" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
  "idempotentKey": "txn_20260302_001",
  "fromWalletId": "wlt_sender_001",
  "toWalletId": "wlt_receiver_002",
  "currency": "USD",
  "amount": 100.5,
  "remark": "Monthly payment"
}'

const response = await fetch(
  'https://api.elaypay.app/api/v1/transfer/command/create',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Api-Key': 'sk_live_xxx',
      'X-Signature': '<computed_signature>',
      'X-Timestamp': '1709337600',
      'X-Nonce': '550e8400-e29b-41d4-a716-446655440000',
    },
    body: JSON.stringify({
      idempotentKey: 'txn_20260302_001',
      fromWalletId: 'wlt_sender_001',
      toWalletId: 'wlt_receiver_002',
      currency: 'USD',
      amount: 100.5,
      remark: 'Monthly payment',
    }),
  }
);
const data = await response.json();

import requests

response = requests.post(
    'https://api.elaypay.app/api/v1/transfer/command/create',
    headers={
        'X-Api-Key': 'sk_live_xxx',
        'X-Signature': '<computed_signature>',
        'X-Timestamp': '1709337600',
        'X-Nonce': '550e8400-e29b-41d4-a716-446655440000',
    },
    json={
        'idempotentKey': 'txn_20260302_001',
        'fromWalletId': 'wlt_sender_001',
        'toWalletId': 'wlt_receiver_002',
        'currency': 'USD',
        'amount': 100.5,
        'remark': 'Monthly payment',
    },
)
data = response.json()

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.elaypay.app/api/v1/transfer/command/create"))
    .header("X-Api-Key", "sk_live_xxx")
    .header("X-Signature", "<computed_signature>")
    .header("X-Timestamp", "1709337600")
    .header("X-Nonce", "550e8400-e29b-41d4-a716-446655440000")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        { "idempotentKey": "txn_20260302_001", "fromWalletId": "wlt_sender_001", "toWalletId": "wlt_receiver_002", "currency": "USD", "amount": 100.5, "remark": "Monthly payment" }
        """))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

Response

Created201

{
  "version": "1.3.0",
  "success": true,
  "code": "2001",
  "message": "CREATED",
  "data": {
    "bizId": "txn_ghi789",
    "fromWalletId": "wlt_sender_001",
    "toWalletId": "wlt_receiver_002",
    "currency": "USD",
    "amount": 100.5,
    "feeAmount": 0.5,
    "totalAmount": 101,
    "status": 10060101,
    "statusName": "PENDING",
    "failureReason": null,
    "remark": "Monthly payment",
    "createdAt": "2026-03-02T11:20:00Z",
    "completedAt": null
  }
}