Skip to main content

Send Payment

Use Vaayu’s Send API to initiate a programmatic stablecoin transfer from your application. Vaayu returns a transaction reference that you can use to track the payment and receive status updates through your configured webhook.
This page follows the current Vaayu /send-payment flow and existing API conventions. Confirm the exact request and response fields against your live FastAPI /docs before publishing.

Endpoint

POST /send-payment Include your Vaayu API key in the X-API-Key header.

Example request

Request body

Example:

Response

A successful request should return a transaction reference and its initial status. For example:
This is an illustrative response, not a guaranteed schema. Use the exact fields and status values returned by your current implementation.

Track the payment

Use the transaction reference returned by the send request with your transaction-status endpoint: GET /transaction/{tx_hash}
A submitted transaction is not necessarily confirmed. Use the status endpoint and webhook events to follow its progress.

Webhooks

If your merchant webhook endpoint is configured, Vaayu can send payment events to your server as the transaction progresses. Your server should:
  • Verify the webhook signature if your integration uses signed webhooks.
  • Respond with a successful HTTP status promptly after accepting the event.
  • Handle duplicate event deliveries safely.
  • Use the transaction reference to correlate events with the original request.
A webhook delivery attempt alone does not prove that a payment succeeded. Check the transaction status in the event or through the status endpoint.

Error handling

For production use, add server-enforced idempotency before automatically retrying send requests. Without it, a retry can potentially create a second payment.

Sandbox and testing

Use Vaayu’s sandbox or test environment while developing. Do not use real funds unless the environment, network, token contract, and recipient address are intentionally configured for a real transfer.
  1. Create or obtain a test API key.
  2. Submit a send request with a valid recipient address for the configured environment.
  3. Save the returned transaction reference.
  4. Check the transaction status.
  5. Confirm that your configured webhook receives the expected event.