Payouts

Get a fiat payout

Returns the latest payout state for the authenticated organization. Requires payout.read permission.

processing means execution is still in progress. completed means the payout completed successfully. A receiving bank can still reject and return a previously completed transfer; the original payout remains completed, while the optional return object describes the bank return and compensating refund. failed means the payout failed before successful bank completion.

get/v2/payouts/{payout_id}

Path parameters

payout_idstring required

Example:fpo_01JQ90GQJTC5P7B2D8N6R4K1MX

Infini fiat payout ID.

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.

Response

Current payout state

code0 required

Business code. 0 means success.

messagestring required

Response message.

Example response

{
  "data": {
    "payout_id": "fpo_01JQ90GQJTC5P7B2D8N6R4K1MX",
    "client_reference_id": "payout_20260730_0001",
    "quote_id": "poq_01JQ90B8S5VJ6R3T7F1M2C4N9X",
    "provider": "sgb",
    "status": "processing",
    "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"
    },
    "purpose_code": "goods_and_services",
    "statement_reference": "INV-2026-0730",
    "bank_reference": "RMTO2084957259539812352",
    "failure": {
      "code": "payout_failed",
      "message": "The payout could not be completed"
    },
    "return": {
      "status": "refunded",
      "reason_code": "recipient_bank_rejected",
      "reason": "Beneficiary bank rejected the transfer",
      "returned_amount": "1000.00",
      "refund_amount": "1000.00",
      "retained_fee": "51.00",
      "currency": "USD",
      "returned_at": 1786674271
    },
    "created_at": 1786587000,
    "updated_at": 1786587001,
    "completed_at": 1786587871
  }
}