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:Track the payment
Use the transaction reference returned by the send request with your transaction-status endpoint:GET /transaction/{tx_hash}
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.
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.- Create or obtain a test API key.
- Submit a send request with a valid recipient address for the configured environment.
- Save the returned transaction reference.
- Check the transaction status.
- Confirm that your configured webhook receives the expected event.