v1

latestOpenAPI 3.0.02026-08-0631647.5 KB

Quotes

Create a payout quote

Validates one bank destination and returns a time-limited SGB payout quote. Requires payout.write permission.

The destination is submitted inline because this release does not expose a separate recipient resource. Infini binds a normalized, immutable destination snapshot to quote_id. The payout create request cannot replace or modify it.

The first release supports only these amount and fee-responsibility combinations:

amount_mode=send with fee_paid_by=BENEFICIARY: fees are deducted internally and receiving_amount = sending_amount - transfer_fee_amount - bank_fee_amount.
amount_mode=receive with fee_paid_by=PAYER: fees are deducted externally and sending_amount = receiving_amount + transfer_fee_amount + bank_fee_amount.

Changing fee_paid_by changes the calculation and requires a new quote. The accepted quote_id locks the fee responsibility and both calculated amounts used by the payout.

The quote step performs preliminary destination, route, amount, compliance, and limit checks. It does not reserve balance, approve a payout, create a payout, or guarantee execution. POST /v2/payouts repeats all execution-critical checks against current state.

post/v2/payouts/quotes

Headers

Datestring

Example:Tue, 30 Jul 2026 08:50:00 GMT

GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required on the wire; the Try it signer injects it automatically.

Authorizationstring

Example:Signature keyId="key_example",algorithm="hmac-sha256",headers="@request-target date",signature="<signature>"

HMAC-SHA256 Signature header. Required on the wire; the Try it signer injects it automatically. See the Authentication guide.

Digeststring

Example:SHA-256=<base64(sha256(request body))>

SHA-256 digest required on the wire when a body is present; the Try it signer injects it automatically.

Request body

amountstring required

Positive USD amount expressed according to amount_mode.

amount_mode'send' | 'receive' required

Side fixed by amount. send is the source-account debit; receive is the recipient amount.

fee_paid_by'PAYER' | 'BENEFICIARY' required

Fee responsibility and calculation input. PAYER applies fees externally; BENEFICIARY deducts fees internally. The first release accepts receive with PAYER, or send with BENEFICIARY.

source_currency'USD' required

Organization balance currency. The first release supports USD only.

destination_currency'USD' required

Currency delivered to the recipient. SGB payout quotes currently support USD only.

destination_countrystring required

Destination country as an ISO 3166-1 alpha-2 code.

payout_type'swift' required

Payout rail. The first SGB release supports SWIFT only.

Example request

{
  "amount": "1000.00",
  "amount_mode": "receive",
  "fee_paid_by": "PAYER",
  "source_currency": "USD",
  "destination_currency": "USD",
  "destination_country": "US",
  "payout_type": "swift",
  "destination": {
    "type": "bank_account",
    "account_holder_type": "business",
    "account_holder_name": "Acme Supplies LLC",
    "bank_country": "US",
    "bank_name": "Example Bank",
    "account_number": "9876543210",
    "swift_code": "BOFAUS3NXXX",
    "address": {
      "line1": "123 Market Street",
      "line2": "Suite 500",
      "city": "New York",
      "state": "NY",
      "postal_code": "10001",
      "country": "US"
    }
  }
}

Response

Time-limited SGB payout quote

code0 required

Business code. 0 means success.

messagestring required

Response message.

Example response

{
  "data": {
    "quote_id": "poq_01JQ90B8S5VJ6R3T7F1M2C4N9X",
    "provider": "sgb",
    "payout_type": "swift",
    "source_currency": "USD",
    "destination_currency": "USD",
    "destination_country": "US",
    "amount_mode": "receive",
    "fee_paid_by": "PAYER",
    "sending_amount": "1051.00",
    "receiving_amount": "1000.00",
    "transfer_fee_amount": "1.00",
    "bank_fee_amount": "50.00",
    "fee_rate_decimal": "0.001",
    "rate": "1",
    "billing": {
      "currency": "USD",
      "transfer_fee": "1.00",
      "fx_fee": "0.00",
      "rail_fee": "50.00",
      "total_fee": "51.00",
      "fee_lines": [
        {
          "type": "transfer_fee",
          "amount": "1.00",
          "currency": "USD",
          "rate": "0.001"
        }
      ]
    },
    "destination": {
      "type": "bank_account",
      "account_holder_type": "business",
      "account_holder_name": "Acme Supplies LLC",
      "bank_country": "US",
      "bank_name": "Example Bank",
      "account_number_masked": "******3210",
      "swift_code": "BOFAUS3NXXX"
    },
    "expires_at": 1786586700
  }
}