Execute Transaction

When to use this

Only after you have a valid quoteId and the source/destination values still match what you priced.

Prerequisites

• A valid x-api-key
• A unique x-idempotency-key for this request
• A quoteId from Generate Quote
• Confirmed source account has sufficient balance

Request

curl --request POST \
  --url $baseUrl/transactions/execute \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: YOUR_UNIQUE_UUID' \
  --data '{
    "quoteId": "string",
    "reason": "gift",
    "reasonDescription": "string",
    "metadata": {},
    "source": {
      "accountId": "string",
      "nadapayCode": "WAL-123",
      "amount": 1000000
    },
    "destination": {
      "beneficiaryAccountId": "string",
      "accountId": "string",
      "nadapayCode": "WAL-456"
    }
  }'

The quoteId must come from the quote step, and the source/destination values here must match what you priced.

Response

Returns the transaction created from the quote. Save the returned transaction identifiers for monitoring and reconciliation.

Common failure reasons

• The quote is expired or invalid
• The source account doesn't have enough balance
• Source/destination values don't match the priced quote
• The transaction is blocked by corridor or compliance conditions

Do not continue if

• The quote is expired or invalid
• The source account has insufficient balance
• Destination values don't match the quote

Call this next

• Get Deposit Instructions (Wallet API)
• Monitor via webhook or session status polling