Create Quote

POST /v0/customers/{customer_id}/pay-out/quote

Create a payout quote for a customer.

Path parameters

• customer_id (string · uuid) — Required The unique identifier of the customer.

Header parameters

• Authorization (string) — Required Token for authentication.

• Idempotency-Key (string) — Required Unique key to prevent duplicate requests.

Body (application/json)

Either source_amount OR destination_amount must be provided to calculate the quote in the desired direction.

You can provide one of the following objects:

• BySourceAmount (object) — Optional Provide source-side details to calculate destination.

• ByDestinationAmount (object) — Optional Provide destination-side details to calculate source.

Either source_amount OR destination_amount must be present — do not provide both as the primary direction of the quote must be specified.

Request example (raw HTTP)

POST /v0/customers/{customer_id}/pay-out/quote HTTP/1.1
Host: gateway.noxxo.com 
Authorization: text 
Idempotency-Key: text 
Content-Type: application/json 
Accept: / Content-Length: 166
{
  "source_amount": "text",
  "source_token": "usdc",
  "source_network": "polygon",
  "destination_currency": "usd",
  "destination_payment_rails": "ach",
  "developer_fee_percent": "0.5"
}

Responses

• 201 — Quote created successfully Content-Type: application/json Response: object

Response example (201 Created)

{
  "quote_id": "123e4567-e89b-12d3-a456-426614174000",
  "source_amount": "100.50",
  "source_token": "usdc",
  "source_network": "ethereum",
  "destination_currency": "usd",
  "destination_payment_rails": "text",
  "destination_amount": "100.50",
  "fee_amount": "10.50",
  "exchange_rate": "text"
}