Skip to main content
POST
Send Payment (Legacy)
This endpoint is deprecated. Use POST /v1/pay with a bank details recipient object instead.
Initiates an outbound fiat payment from the project’s wallet to an external US bank account via Bridge.xyz off-ramp. The project balance is debited atomically before the transfer is initiated. If the transfer fails, the balance is automatically restored.
Requires a bearer token with the pay permission.

Request Body

integer
required
Payment amount in cents. Must be between 1 and 100,000,000 ($1,000,000.00).
object
required
Recipient bank account details.
string
Payment description for record-keeping. Max 500 characters.
string
Unique key to prevent duplicate payments. Alphanumeric plus _, -, :, .. Max 255 characters.

Response

string
required
Unique transaction identifier.
string
required
Transaction status: pending, processing, completed, or failed.
integer
required
Payment amount in cents.
string
required
Name of the payment recipient.
string
required
ISO 8601 timestamp of when the payment was created.
string | null
required
Estimated delivery time (e.g., “2-3 business days”). null if no ACH transfer was initiated.

Examples

Response (201 Created)

Idempotency

If you provide an idempotency_key and a transaction with that key already exists for this project, the API returns the original transaction with a 200 OK status (not 201 Created). The request body is not re-evaluated.
Always include an idempotency key when sending payments from automated agents. Use a deterministic key tied to your business logic (e.g., invoice number, order ID) to guarantee at-most-once delivery.