{"items":[{"type":"link","label":"Infini Fiat Payout API","link":"/apis/payout","routeSlug":"/apis/payout","content":{"contentType":"overview","meta":{"name":"Infini Fiat Payout API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"payout.json","url":"/_bundle/apis/payout.json?download"},{"kind":"download","label":"payout.yaml","url":"/_bundle/apis/payout.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Infini Fiat Payout API (0.4.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Fiat Payout API lets an organization quote, create, and query direct USD bank payouts from its Infini USD balance to a third-party bank account."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All endpoints use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v2/payouts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix. Requests require "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/en/4-authorization"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and an API key with the relevant payout permission."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v2/payouts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not enter the dashboard approval workflow. Infini performs final authorization, compliance, quote, destination, limit, and available-balance checks and then starts payout execution immediately. Bank settlement is asynchronous, so a successful create response normally has "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status=processing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; it does not guarantee that the receiving bank account has already been credited."},"children":[]}]}]}]}],"sectionId":"/apis/payout"}],"sectionId":"/apis/payout"}]}]}},{"type":"group","label":"Quotes","link":"/apis/payout/quotes","routeSlug":"/apis/payout/quotes","items":[{"label":"Create a payout quote","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/payout/quotes/createfiatpayoutquote","routeSlug":"/apis/payout/quotes/createfiatpayoutquote","metadata":{"seo":{"title":"Create a payout quote","description":"Validates one bank destination and returns a time-limited payout quote. Requires payout.write permission."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createFiatPayoutQuote","name":"Create a payout quote","isWebhook":false,"pointer":"/paths/~1v2~1payouts~1quotes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a payout quote","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validates one bank destination and returns a time-limited payout quote. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout.write"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" permission."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The destination is submitted inline because this release does not expose a separate recipient resource. Infini binds a normalized, immutable destination snapshot to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The payout create request cannot replace or modify it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The first release supports only these amount and fee-responsibility combinations:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount_mode=send"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_paid_by=BENEFICIARY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": fees are deducted internally. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fixes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sending_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transfer_fee_amount = sending_amount × fee_rate_decimal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"receiving_amount = sending_amount - transfer_fee_amount - bank_fee_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount=1000.00"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", rate "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.001"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and bank fee "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50.00"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the recipient receives "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"949.00"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount_mode=receive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_paid_by=PAYER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": fees are deducted externally. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fixes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"receiving_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transfer_fee_amount = sending_amount × fee_rate_decimal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sending_amount = receiving_amount + transfer_fee_amount + bank_fee_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount=1000.00"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", rate "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.001"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and bank fee "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50.00"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the source balance is debited "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1051.05"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"receive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" mode, Infini grosses up "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sending_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until the recipient amount remains exact after all fees."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_paid_by"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" changes the calculation and requires a new quote. The accepted "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" locks the fee responsibility and both calculated amounts used by the payout."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"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. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v2/payouts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" repeats all execution-critical checks against current state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"InfiniHmac","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sandbox API "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (keyId) and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the Infini dashboard."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Date","in":"header","schemaId":"schema_70","description":"GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required on the wire; the Try it signer injects it automatically."},{"name":"Authorization","in":"header","schemaId":"schema_71","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Signature"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header. Required on the wire; the Try it signer injects it automatically. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/en/4-authorization"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" guide."},"children":[]}]}]}]},{"name":"Digest","in":"header","schemaId":"schema_72","description":"SHA-256 digest required on the wire when a body is present; the Try it signer injects it automatically."}],"pointer":"/paths/~1v2~1payouts~1quotes/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v2~1payouts~1quotes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v2/payouts/quotes","servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Date","in":"header","required":false,"example":"Tue, 30 Jul 2026 08:50:00 GMT","schemaId":"schema_70"},{"name":"Authorization","in":"header","required":false,"example":"Signature keyId=\"key_example\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"","schemaId":"schema_71"},{"name":"Digest","in":"header","required":false,"example":"SHA-256=<base64(sha256(request body))>","schemaId":"schema_72"}],"cookie":[]},"security":[{"schemes":[{"id":"InfiniHmac","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","409","422","500"],"requestValues":{"envVariables":{"INFINI_KEY_ID":"YOUR_KEY_ID","INFINI_SECRET":"YOUR_SECRET","INFINI_BASE_URL":"https://openapi-sandbox.infini.money"}},"pointer":"/v2/payouts/quotes","href":"quotes/createfiatpayoutquote","openApiOperationId":"createFiatPayoutQuote","summary":"Create a payout quote"},"definitionSamples":[{"lang":"curl","label":"cURL (HMAC)","source":"curl -i -X POST \\\n  '{{INFINI_BASE_URL}}/v2/payouts/quotes' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Date: <GMT date>' \\\n  -H 'Digest: SHA-256=<base64(sha256(request body))>' \\\n  -H 'Authorization: Signature keyId=\"{{INFINI_KEY_ID}}\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"' \\\n  -d '{\n    \"amount\": \"1000.00\",\n    \"amount_mode\": \"receive\",\n    \"fee_paid_by\": \"PAYER\",\n    \"source_currency\": \"USD\",\n    \"destination_currency\": \"USD\",\n    \"destination_country\": \"US\",\n    \"payout_type\": \"swift\",\n    \"destination\": {\n      \"type\": \"bank_account\",\n      \"account_holder_type\": \"business\",\n      \"account_holder_name\": \"Acme Supplies LLC\",\n      \"bank_country\": \"US\",\n      \"bank_name\": \"Example Bank\",\n      \"account_number\": \"9876543210\",\n      \"swift_code\": \"BOFAUS3NXXX\",\n      \"address\": {\n        \"line1\": \"123 Market Street\",\n        \"line2\": \"Suite 500\",\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"postal_code\": \"10001\",\n        \"country\": \"US\"\n      }\n    }\n  }'"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Time-limited payout quote","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/QuoteEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/QuoteEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Request syntax or field validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/400/content/application~1json/example"]},{"code":"401","description":"HMAC gateway validation or application authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]},{"code":"403","description":"API key permission, IP whitelist, or organization eligibility rejected the request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]},{"code":"409","description":"The request conflicts with idempotency, quote state, or another payout submission","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"]},{"code":"422","description":"Request is syntactically valid but cannot pass payout eligibility or execution checks","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/dailyLimitExceeded"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/dailyLimitExceeded"]},{"code":"500","description":"An unexpected internal error occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1v2~1payouts~1quotes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/QuoteEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/QuoteEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}}},{"code":"403","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}}},{"code":"409","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"]}}},{"code":"422","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/dailyLimitExceeded"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/dailyLimitExceeded"]}}},{"code":"500","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1quotes/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/quotes/createfiatpayoutquote"}],"panels":[]}]},"httpPath":"/v2/payouts/quotes"}],"content":{"contentType":"group","meta":{"name":"Quotes"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Quotes","showPageActions":true},{"nodeType":"markdoc","content":"Time-limited payout pricing and destination validation"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v2/payouts/quotes","summary":"Create a payout quote","prefix":{"name":"post","color":"post"},"badges":[],"link":"/quotes/createfiatpayoutquote","deprecated":false}]}]}]}]}},{"type":"group","label":"Payouts","link":"/apis/payout/payouts","routeSlug":"/apis/payout/payouts","items":[{"label":"Create a fiat payout","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/payout/payouts/createfiatpayout","routeSlug":"/apis/payout/payouts/createfiatpayout","metadata":{"seo":{"title":"Create a fiat payout","description":"Creates and immediately starts a payout using a valid quote. Requires payout.write permission. The payout does not enter the dashboard approval workflow."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createFiatPayout","name":"Create a fiat payout","isWebhook":false,"pointer":"/paths/~1v2~1payouts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a fiat payout","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates and immediately starts a payout using a valid quote. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout.write"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" permission. The payout does not enter the dashboard approval workflow."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" binds the provider, destination snapshot, source and destination currencies, payout rail, amount mode, fee responsibility, exchange rate, amounts, and fee breakdown. Do not repeat those fields in this request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This operation performs the authoritative pre-execution checks, including API-key ownership and permissions, quote ownership and expiry, request-to-quote consistency, account and destination validation, compliance controls, limits, available balance, execution-provider availability, and idempotency."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must uniquely identify one logical payout within the authenticated organization. Retrying the same business request returns the existing payout with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_duplicate=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Reusing the value with different request data returns a conflict."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A successful response means the payout was accepted and bank execution started. It does not mean the receiving bank has credited the account. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v2/payouts/{payout_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to obtain the latest state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only one payout submission per organization can enter execution at a time. A concurrent submission is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"108015 payout_submission_in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before the quote is consumed, a payout is created, or the balance is debited. Retry after a short randomized delay and keep the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the same logical payout."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"InfiniHmac","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sandbox API "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (keyId) and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the Infini dashboard."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Date","in":"header","schemaId":"schema_70","description":"GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required on the wire; the Try it signer injects it automatically."},{"name":"Authorization","in":"header","schemaId":"schema_71","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Signature"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header. Required on the wire; the Try it signer injects it automatically. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/en/4-authorization"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" guide."},"children":[]}]}]}]},{"name":"Digest","in":"header","schemaId":"schema_72","description":"SHA-256 digest required on the wire when a body is present; the Try it signer injects it automatically."}],"pointer":"/paths/~1v2~1payouts/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePayoutRequest","exampleIds":["paths/~1v2~1payouts/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreatePayoutRequest","exampleIds":["paths/~1v2~1payouts/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v2~1payouts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v2/payouts","servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Date","in":"header","required":false,"example":"Tue, 30 Jul 2026 08:50:00 GMT","schemaId":"schema_70"},{"name":"Authorization","in":"header","required":false,"example":"Signature keyId=\"key_example\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"","schemaId":"schema_71"},{"name":"Digest","in":"header","required":false,"example":"SHA-256=<base64(sha256(request body))>","schemaId":"schema_72"}],"cookie":[]},"security":[{"schemes":[{"id":"InfiniHmac","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePayoutRequest","exampleIds":["paths/~1v2~1payouts/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","409","422","500","503"],"requestValues":{"envVariables":{"INFINI_KEY_ID":"YOUR_KEY_ID","INFINI_SECRET":"YOUR_SECRET","INFINI_BASE_URL":"https://openapi-sandbox.infini.money"}},"pointer":"/v2/payouts","href":"payouts/createfiatpayout","openApiOperationId":"createFiatPayout","summary":"Create a fiat payout"},"definitionSamples":[{"lang":"curl","label":"cURL (HMAC)","source":"curl -i -X POST \\\n  '{{INFINI_BASE_URL}}/v2/payouts' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Date: <GMT date>' \\\n  -H 'Digest: SHA-256=<base64(sha256(request body))>' \\\n  -H 'Authorization: Signature keyId=\"{{INFINI_KEY_ID}}\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"' \\\n  -d '{\n    \"client_reference_id\": \"payout_20260730_0001\",\n    \"quote_id\": \"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X\",\n    \"purpose_code\": \"goods_and_services\",\n    \"statement_reference\": \"INV-2026-0730\"\n  }'"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"schemaId":"components/schemas/CreatePayoutRequest","exampleIds":["paths/~1v2~1payouts/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePayoutRequest","exampleIds":["paths/~1v2~1payouts/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout created or an idempotent existing payout returned","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Request syntax or field validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/400/content/application~1json/example"]},{"code":"401","description":"HMAC gateway validation or application authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]},{"code":"403","description":"API key permission, IP whitelist, or organization eligibility rejected the request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]},{"code":"404","description":"Resource was not found for the authenticated organization","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/quoteNotFound"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/quoteNotFound"]},{"code":"409","description":"The request conflicts with idempotency, quote state, or another payout submission","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"]},{"code":"422","description":"Request is syntactically valid but cannot pass payout eligibility or execution checks","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/dailyLimitExceeded"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/dailyLimitExceeded"]},{"code":"500","description":"An unexpected internal error occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/500/content/application~1json/example"]},{"code":"503","description":"Payout execution service or provider liquidity is temporarily unavailable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/503/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/503/content/application~1json/example"]}],"pointer":"/paths/~1v2~1payouts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}}},{"code":"403","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}}},{"code":"404","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/quoteNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/quoteNotFound"]}}},{"code":"409","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/idempotencyConflict","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteAlreadyUsed","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteNotActive","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/submissionInProgress","paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"]}}},{"code":"422","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/dailyLimitExceeded"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/invalidFeeMode","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteExpired","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteUnavailable","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountExceedsLimit","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountTooSmall","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/insufficientBalance","paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/dailyLimitExceeded"]}}},{"code":"500","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/500/content/application~1json/example"]}}},{"code":"503","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/503/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts/post/responses/503/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payouts/createfiatpayout"}],"panels":[]}]},"httpPath":"/v2/payouts"},{"label":"List fiat payout statuses","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/payout/payouts/batchgetfiatpayoutstatuses","routeSlug":"/apis/payout/payouts/batchgetfiatpayoutstatuses","metadata":{"seo":{"title":"List fiat payout statuses","description":"Returns fiat payouts owned by the authenticated organization whose creation time falls within the inclusive start_time and end_time range. Requires payout.read permission."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"batchGetFiatPayoutStatuses","name":"List fiat payout statuses","isWebhook":false,"pointer":"/paths/~1v2~1payouts~1status~1batch/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List fiat payout statuses","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns fiat payouts owned by the authenticated organization whose creation time falls within the inclusive "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start_time"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"end_time"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" range. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout.read"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" permission."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are ordered by creation time descending and use page-based pagination. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"page_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"20"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and cannot exceed "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint for periodic time-window reconciliation. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v2/payouts/{payout_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when retrieving one known payout."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"InfiniHmac","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sandbox API "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (keyId) and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the Infini dashboard."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Date","in":"header","schemaId":"schema_70","description":"GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required on the wire; the Try it signer injects it automatically."},{"name":"Authorization","in":"header","schemaId":"schema_71","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Signature"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header. Required on the wire; the Try it signer injects it automatically. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/en/4-authorization"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" guide."},"children":[]}]}]}]},{"name":"Digest","in":"header","schemaId":"schema_72","description":"SHA-256 digest required on the wire when a body is present; the Try it signer injects it automatically."}],"pointer":"/paths/~1v2~1payouts~1status~1batch/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BatchPayoutStatusRequest","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/BatchPayoutStatusRequest","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v2~1payouts~1status~1batch/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v2/payouts/status/batch","servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Date","in":"header","required":false,"example":"Tue, 30 Jul 2026 08:50:00 GMT","schemaId":"schema_70"},{"name":"Authorization","in":"header","required":false,"example":"Signature keyId=\"key_example\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"","schemaId":"schema_71"},{"name":"Digest","in":"header","required":false,"example":"SHA-256=<base64(sha256(request body))>","schemaId":"schema_72"}],"cookie":[]},"security":[{"schemes":[{"id":"InfiniHmac","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BatchPayoutStatusRequest","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","500"],"requestValues":{"envVariables":{"INFINI_KEY_ID":"YOUR_KEY_ID","INFINI_SECRET":"YOUR_SECRET","INFINI_BASE_URL":"https://openapi-sandbox.infini.money"}},"pointer":"/v2/payouts/status/batch","href":"payouts/batchgetfiatpayoutstatuses","openApiOperationId":"batchGetFiatPayoutStatuses","summary":"List fiat payout statuses"},"definitionSamples":[{"lang":"curl","label":"cURL (HMAC)","source":"curl -i -X POST \\\n  '{{INFINI_BASE_URL}}/v2/payouts/status/batch' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Date: <GMT date>' \\\n  -H 'Digest: SHA-256=<base64(sha256(request body))>' \\\n  -H 'Authorization: Signature keyId=\"{{INFINI_KEY_ID}}\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"' \\\n  -d '{\n    \"start_time\": 1786500000,\n    \"end_time\": 1786599999,\n    \"page\": 1,\n    \"page_size\": 20\n  }'"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"schemaId":"components/schemas/BatchPayoutStatusRequest","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BatchPayoutStatusRequest","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout statuses in creation-time descending order with pagination","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchPayoutStatusEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/BatchPayoutStatusEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Request syntax or field validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/400/content/application~1json/example"]},{"code":"401","description":"HMAC gateway validation or application authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]},{"code":"403","description":"API key permission, IP whitelist, or organization eligibility rejected the request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]},{"code":"500","description":"An unexpected internal error occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1v2~1payouts~1status~1batch/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BatchPayoutStatusEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchPayoutStatusEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}}},{"code":"403","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}}},{"code":"500","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1status~1batch/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payouts/batchgetfiatpayoutstatuses"}],"panels":[]}]},"httpPath":"/v2/payouts/status/batch"},{"label":"Get a fiat payout","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/payout/payouts/getfiatpayout","routeSlug":"/apis/payout/payouts/getfiatpayout","metadata":{"seo":{"title":"Get a fiat payout","description":"Returns the latest payout state for the authenticated organization. Requires payout.read permission."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getFiatPayout","name":"Get a fiat payout","isWebhook":false,"pointer":"/paths/~1v2~1payouts~1{payout_id}/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a fiat payout","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the latest payout state for the authenticated organization. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout.read"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" permission."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means execution is still in progress. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the payout completed successfully. A receiving bank can still reject and return a previously completed transfer; the original payout remains "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", while the optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object describes the bank return and compensating refund. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the payout failed before successful bank completion."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"InfiniHmac","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sandbox API "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (keyId) and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the Infini dashboard."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"payout_id","in":"path","schemaId":"schema_74","description":"Infini fiat payout ID.","required":true}],"pointer":"/paths/~1v2~1payouts~1{payout_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Date","in":"header","schemaId":"schema_70","description":"GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required on the wire; the Try it signer injects it automatically."},{"name":"Authorization","in":"header","schemaId":"schema_71","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Signature"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header. Required on the wire; the Try it signer injects it automatically. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/en/4-authorization"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" guide."},"children":[]}]}]}]}],"pointer":"/paths/~1v2~1payouts~1{payout_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v2/payouts/{payout_id}","servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"parameters":{"path":[{"name":"payout_id","in":"path","required":true,"example":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX","schemaId":"schema_74"}],"query":[],"querystring":[],"header":[{"name":"Date","in":"header","required":false,"example":"Tue, 30 Jul 2026 08:50:00 GMT","schemaId":"schema_70"},{"name":"Authorization","in":"header","required":false,"example":"Signature keyId=\"key_example\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"","schemaId":"schema_71"}],"cookie":[]},"security":[{"schemes":[{"id":"InfiniHmac","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"requestValues":{"envVariables":{"INFINI_KEY_ID":"YOUR_KEY_ID","INFINI_SECRET":"YOUR_SECRET","INFINI_BASE_URL":"https://openapi-sandbox.infini.money"}},"pointer":"/v2/payouts/{payout_id}","href":"payouts/getfiatpayout","openApiOperationId":"getFiatPayout","summary":"Get a fiat payout"},"definitionSamples":[{"lang":"curl","label":"cURL (HMAC)","source":"curl -i -X GET \\\n  '{{INFINI_BASE_URL}}/v2/payouts/fpo_01JQ90GQJTC5P7B2D8N6R4K1MX' \\\n  -H 'Date: <GMT date>' \\\n  -H 'Authorization: Signature keyId=\"{{INFINI_KEY_ID}}\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\"'"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/payout","description":"Mock server","isMockServer":true},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Current payout state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/processing","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/completed","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/bank_returned"]}},"schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/processing","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/completed","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/bank_returned"]},{"code":"400","description":"Request syntax or field validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/400/content/application~1json/example"]},{"code":"401","description":"HMAC gateway validation or application authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]},{"code":"403","description":"API key permission, IP whitelist, or organization eligibility rejected the request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}},"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]},{"code":"404","description":"Resource was not found for the authenticated organization","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/quoteNotFound"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/quoteNotFound"]},{"code":"500","description":"An unexpected internal error occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1v2~1payouts~1{payout_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/processing","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/completed","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/bank_returned"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PayoutEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/processing","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/completed","paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/bank_returned"]}}},{"code":"400","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/applicationAuthenticationFailed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/gatewayAuthenticationFailed","paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/applicationAuthenticationFailed"]}}},{"code":"403","schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/permissionDenied","paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"]}}},{"code":"404","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/quoteNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/payoutNotFound","paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/quoteNotFound"]}}},{"code":"500","schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorEnvelope","exampleIds":["paths/~1v2~1payouts~1{payout_id}/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payouts/getfiatpayout"}],"panels":[]}]},"httpPath":"/v2/payouts/{payout_id}"}],"content":{"contentType":"group","meta":{"name":"Payouts"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payouts","showPageActions":true},{"nodeType":"markdoc","content":"Direct fiat payout execution and status"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v2/payouts","summary":"Create a fiat payout","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payouts/createfiatpayout","deprecated":false},{"title":"/v2/payouts/status/batch","summary":"List fiat payout statuses","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payouts/batchgetfiatpayoutstatuses","deprecated":false},{"title":"/v2/payouts/{payout_id}","summary":"Get a fiat payout","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payouts/getfiatpayout","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/StandardEnvelope":{"id":"components/schemas/StandardEnvelope","kind":"json-schema","title":"StandardEnvelope","data":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","enum":[0],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Business code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means success."},"children":[]}]}]}],"example":0},"message":{"type":"string","description":"Response message.","example":""}}}},"components/schemas/ErrorEnvelope":{"id":"components/schemas/ErrorEnvelope","kind":"json-schema","title":"ErrorEnvelope","data":{"type":"object","required":["code","message","data"],"properties":{"code":{"type":"integer","minimum":1,"description":"Stable non-zero business error code. Fiat Payout-specific errors use the reserved 108001-108099 range.","example":108002},"message":{"type":"string","description":"Human-readable error details for troubleshooting, not program control.","example":"Quote has expired"},"data":{"$ref":"#/components/schemas/ErrorData"}}}},"components/schemas/ErrorData":{"id":"components/schemas/ErrorData","kind":"json-schema","title":"ErrorData","data":{"type":"object","required":["error","field","retryable"],"properties":{"error":{"type":"string","description":"Stable machine-readable error identifier.","example":"quote_expired"},"field":{"type":"string","nullable":true,"description":"Request field related to the error, when applicable.","example":"quote_id"},"retryable":{"type":"boolean","description":"Whether retrying after correcting transient state can succeed.","example":true}}}},"components/schemas/GatewayError":{"id":"components/schemas/GatewayError","kind":"json-schema","title":"GatewayError","data":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","description":"Gateway validation error.","example":"client request can't be validated"}}}},"components/schemas/CreateQuoteRequest":{"id":"components/schemas/CreateQuoteRequest","kind":"json-schema","title":"CreateQuoteRequest","data":{"type":"object","additionalProperties":false,"required":["amount","amount_mode","fee_paid_by","source_currency","destination_currency","destination_country","payout_type","destination"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Positive USD amount expressed according to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount_mode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"1000.00"},"amount_mode":{"type":"string","enum":["send","receive"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Side fixed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"send"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the source-account debit; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"receive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the recipient amount."},"children":[]}]}]}],"example":"receive"},"fee_paid_by":{"type":"string","enum":["PAYER","BENEFICIARY"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fee responsibility and calculation input. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" applies fees externally; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BENEFICIARY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" deducts fees internally. The first release accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"receive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"send"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BENEFICIARY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"PAYER"},"source_currency":{"type":"string","enum":["USD"],"description":"Organization balance currency. The first release supports USD only.","example":"USD"},"destination_currency":{"type":"string","enum":["USD"],"description":"Currency delivered to the recipient. Payout quotes currently support USD only.","example":"USD"},"destination_country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Destination country as an ISO 3166-1 alpha-2 code.","example":"US"},"payout_type":{"type":"string","enum":["swift"],"description":"Payout rail. The current release supports SWIFT only.","example":"swift"},"destination":{"$ref":"#/components/schemas/BankDestinationInput"}}}},"components/schemas/BankDestinationInput":{"id":"components/schemas/BankDestinationInput","kind":"json-schema","title":"BankDestinationInput","data":{"type":"object","additionalProperties":false,"required":["type","account_holder_type","account_holder_name","bank_country","bank_name","account_number","swift_code"],"properties":{"type":{"type":"string","enum":["bank_account"],"description":"Destination type.","example":"bank_account"},"account_holder_type":{"type":"string","enum":["individual","business"],"description":"Legal type of the bank-account holder.","example":"business"},"account_holder_name":{"type":"string","minLength":1,"maxLength":140,"description":"Full legal name registered on the bank account.","example":"Acme Supplies LLC"},"bank_country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Bank country as an ISO 3166-1 alpha-2 code.","example":"US"},"bank_name":{"type":"string","minLength":1,"maxLength":140,"description":"Receiving bank's legal name.","example":"Example Bank"},"account_number":{"type":"string","minLength":4,"maxLength":34,"writeOnly":true,"description":"Receiving bank account number.","example":"9876543210"},"swift_code":{"type":"string","pattern":"^[A-Z0-9]{8}([A-Z0-9]{3})?$","description":"Receiving bank SWIFT/BIC code.","example":"BOFAUS3NXXX"},"address":{"$ref":"#/components/schemas/PostalAddress"}}}},"components/schemas/PostalAddress":{"id":"components/schemas/PostalAddress","kind":"json-schema","title":"PostalAddress","data":{"type":"object","additionalProperties":false,"required":["line1","city","postal_code","country"],"properties":{"line1":{"type":"string","description":"Primary street address.","example":"123 Market Street"},"line2":{"type":"string","nullable":true,"description":"Secondary address details.","example":"Suite 500"},"city":{"type":"string","description":"City or locality.","example":"New York"},"state":{"type":"string","nullable":true,"description":"State, province, or region.","example":"NY"},"postal_code":{"type":"string","description":"Postal or ZIP code.","example":"10001"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Address country as an ISO 3166-1 alpha-2 code.","example":"US"}}}},"components/schemas/BankDestinationView":{"id":"components/schemas/BankDestinationView","kind":"json-schema","title":"BankDestinationView","data":{"type":"object","required":["type","account_holder_type","account_holder_name","bank_country","bank_name","account_number_masked","swift_code"],"properties":{"type":{"type":"string","enum":["bank_account"],"description":"Destination type.","example":"bank_account"},"account_holder_type":{"type":"string","enum":["individual","business"],"description":"Legal type of the bank-account holder.","example":"business"},"account_holder_name":{"type":"string","description":"Full legal name registered on the bank account.","example":"Acme Supplies LLC"},"bank_country":{"type":"string","description":"Bank country as an ISO 3166-1 alpha-2 code.","example":"US"},"bank_name":{"type":"string","description":"Receiving bank's legal name.","example":"Example Bank"},"account_number_masked":{"type":"string","description":"Masked account number. Raw account details are never returned.","example":"******3210"},"swift_code":{"type":"string","description":"Receiving bank SWIFT/BIC code.","example":"BOFAUS3NXXX"}}}},"components/schemas/FeeLine":{"id":"components/schemas/FeeLine","kind":"json-schema","title":"FeeLine","data":{"type":"object","additionalProperties":false,"required":["type","amount","currency","rate"],"properties":{"type":{"type":"string","enum":["transfer_fee","fx_fee","rail_fee"],"description":"Fee component type.","example":"transfer_fee"},"amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fee component amount in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"1.05"},"currency":{"type":"string","enum":["USD"],"description":"Fee component currency.","example":"USD"},"rate":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Decimal rate used for this fee line, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a fixed rail fee."},"children":[]}]}]}],"example":"0.001"}}}},"components/schemas/BillingBreakdown":{"id":"components/schemas/BillingBreakdown","kind":"json-schema","title":"BillingBreakdown","data":{"type":"object","additionalProperties":false,"required":["currency","transfer_fee","fx_fee","rail_fee","total_fee","fee_lines"],"properties":{"currency":{"type":"string","enum":["USD"],"description":"Currency used by all billing amounts.","example":"USD"},"transfer_fee":{"type":"string","description":"Infini service fee for processing the payout. It does not include any bank or rail fee.","example":"1.05"},"fx_fee":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Foreign-exchange fee. It is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.00"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the current USD-to-USD route."},"children":[]}]}]}],"example":"0.00"},"rail_fee":{"type":"string","description":"Banking fee associated with the selected bank and payout rail.","example":"50.00"},"total_fee":{"type":"string","description":"Sum of all fee components in the billing breakdown.","example":"51.05"},"fee_lines":{"type":"array","description":"Itemized fee components used for reconciliation.","items":{"$ref":"#/components/schemas/FeeLine"}}}}},"components/schemas/Quote":{"id":"components/schemas/Quote","kind":"json-schema","title":"Quote","data":{"type":"object","required":["quote_id","provider","payout_type","source_currency","destination_currency","destination_country","amount_mode","fee_paid_by","sending_amount","receiving_amount","transfer_fee_amount","bank_fee_amount","fee_rate_decimal","rate","billing","destination","expires_at"],"properties":{"quote_id":{"type":"string","description":"Time-limited payout quote ID.","example":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X"},"provider":{"type":"string","enum":["sgb"],"readOnly":true,"description":"Read-only execution provider identifier.","example":"sgb"},"payout_type":{"type":"string","enum":["swift"],"description":"Payout rail bound to the quote.","example":"swift"},"source_currency":{"type":"string","enum":["USD"],"description":"Organization balance currency.","example":"USD"},"destination_currency":{"type":"string","enum":["USD"],"description":"Currency delivered to the recipient.","example":"USD"},"destination_country":{"type":"string","description":"Destination country as an ISO 3166-1 alpha-2 code.","example":"US"},"amount_mode":{"type":"string","enum":["send","receive"],"description":"Side fixed by the quote request.","example":"receive"},"fee_paid_by":{"type":"string","enum":["PAYER","BENEFICIARY"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Party responsible for payout fees. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means external deduction; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BENEFICIARY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means internal deduction."},"children":[]}]}]}],"example":"PAYER"},"sending_amount":{"type":"string","description":"Total amount debited from the organization's source balance. Use this as the outgoing amount for reconciliation.","example":"1051.05"},"receiving_amount":{"type":"string","description":"Amount delivered to the recipient.","example":"1000.00"},"transfer_fee_amount":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Infini service fee for processing the payout. It excludes any bank or rail fee and equals "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"billing.transfer_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"1.05"},"bank_fee_amount":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Banking fee associated with the selected bank and payout rail, such as SWIFT, ACH, or wire. This equals "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"billing.rail_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"50.00"},"fee_rate_decimal":{"type":"string","description":"Decimal transfer-fee rate applied to the quote.","example":"0.001"},"rate":{"type":"string","description":"Destination-currency units per one source-currency unit.","example":"1"},"billing":{"$ref":"#/components/schemas/BillingBreakdown"},"destination":{"$ref":"#/components/schemas/BankDestinationView"},"expires_at":{"type":"integer","format":"int64","description":"Quote expiry time as Unix seconds.","example":1786586700}}}},"components/schemas/QuoteEnvelope":{"id":"components/schemas/QuoteEnvelope","kind":"json-schema","title":"QuoteEnvelope","data":{"allOf":[{"$ref":"#/components/schemas/StandardEnvelope"},{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Quote"}}}]}},"components/schemas/CreatePayoutRequest":{"id":"components/schemas/CreatePayoutRequest","kind":"json-schema","title":"CreatePayoutRequest","data":{"type":"object","additionalProperties":false,"required":["client_reference_id","quote_id","purpose_code"],"properties":{"client_reference_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9._-]+$","description":"Merchant-scoped idempotency and reconciliation reference for one logical payout.","example":"payout_20260730_0001"},"quote_id":{"type":"string","description":"Unexpired quote owned by the authenticated organization. It binds the destination, amounts, fee responsibility, provider, rail, and pricing.","example":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X"},"purpose_code":{"type":"string","minLength":1,"maxLength":64,"description":"Business purpose code accepted for the payout corridor.","example":"goods_and_services"},"statement_reference":{"type":"string","minLength":1,"maxLength":35,"description":"Reference displayed to the recipient when supported by the bank rail.","example":"INV-2026-0730"}}}},"components/schemas/BatchPayoutStatusRequest":{"id":"components/schemas/BatchPayoutStatusRequest","kind":"json-schema","title":"BatchPayoutStatusRequest","data":{"type":"object","additionalProperties":false,"required":["start_time","end_time"],"properties":{"start_time":{"type":"integer","format":"int64","minimum":1,"description":"Inclusive payout creation start time as Unix seconds.","example":1786500000},"end_time":{"type":"integer","format":"int64","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Inclusive payout creation end time as Unix seconds. Must be greater than or equal to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start_time"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1786599999},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number.","example":1},"page_size":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Number of payouts per page.","example":20}}}},"components/schemas/PayoutStatusItem":{"id":"components/schemas/PayoutStatusItem","kind":"json-schema","title":"PayoutStatusItem","data":{"type":"object","additionalProperties":false,"required":["payout_id","client_reference_id","quote_id","provider","status","payout_type","source_currency","destination_currency","destination_country","amount_mode","fee_paid_by","sending_amount","receiving_amount","transfer_fee_amount","bank_fee_amount","fee_rate_decimal","rate","billing","destination","purpose_code","statement_reference","bank_reference","failure","return","created_at","updated_at","completed_at"],"properties":{"payout_id":{"type":"string","description":"Infini fiat payout ID.","example":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX"},"client_reference_id":{"type":"string","description":"Merchant-provided payout reconciliation reference.","example":"payout_20260730_0001"},"quote_id":{"type":"string","description":"Quote used to create the payout.","example":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X"},"provider":{"type":"string","enum":["sgb"],"readOnly":true,"description":"Execution provider selected by Infini.","example":"sgb"},"status":{"type":"string","enum":["processing","completed","failed"],"description":"Current payout lifecycle state.","example":"completed"},"payout_type":{"type":"string","enum":["swift"],"description":"Payout rail bound by the quote.","example":"swift"},"source_currency":{"type":"string","enum":["USD"],"description":"Organization balance currency.","example":"USD"},"destination_currency":{"type":"string","enum":["USD"],"description":"Currency delivered to the recipient.","example":"USD"},"destination_country":{"type":"string","description":"Destination country as an ISO 3166-1 alpha-2 code.","example":"US"},"amount_mode":{"type":"string","enum":["send","receive"],"description":"Side fixed by the accepted quote.","example":"receive"},"fee_paid_by":{"type":"string","enum":["PAYER","BENEFICIARY"],"description":"Party responsible for payout fees.","example":"PAYER"},"sending_amount":{"type":"string","description":"Actual total source-balance debit.","example":"1051.05"},"receiving_amount":{"type":"string","description":"Amount delivered to the recipient.","example":"1000.00"},"transfer_fee_amount":{"type":"string","description":"Infini service fee frozen by the quote.","example":"1.05"},"bank_fee_amount":{"type":"string","description":"Banking fee frozen by the quote.","example":"50.00"},"fee_rate_decimal":{"type":"string","description":"Decimal transfer-fee rate frozen by the quote.","example":"0.001"},"rate":{"type":"string","description":"Exchange rate frozen by the quote.","example":"1"},"billing":{"$ref":"#/components/schemas/BillingBreakdown"},"destination":{"$ref":"#/components/schemas/BankDestinationView"},"purpose_code":{"type":"string","description":"Business purpose supplied at creation.","example":"goods_and_services"},"statement_reference":{"type":"string","nullable":true,"description":"Recipient-facing reference when supported.","example":"INV-2026-0730"},"bank_reference":{"type":"string","nullable":true,"description":"Bank transfer reference when available.","example":"RMTO2084957259539812352"},"failure":{"$ref":"#/components/schemas/Failure"},"return":{"$ref":"#/components/schemas/PayoutReturn"},"created_at":{"type":"integer","format":"int64","description":"Payout creation time as Unix seconds.","example":1786587000},"updated_at":{"type":"integer","format":"int64","description":"Payout last-update time as Unix seconds.","example":1786587871},"completed_at":{"type":"integer","format":"int64","nullable":true,"description":"Payout completion time as Unix seconds when available.","example":1786587871}}}},"components/schemas/BatchPayoutStatusEnvelope":{"id":"components/schemas/BatchPayoutStatusEnvelope","kind":"json-schema","title":"BatchPayoutStatusEnvelope","data":{"allOf":[{"$ref":"#/components/schemas/StandardEnvelope"},{"type":"object","required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["payouts","total","page","page_size","total_pages"],"properties":{"payouts":{"type":"array","description":"Payout statuses ordered by creation time descending.","items":{"$ref":"#/components/schemas/PayoutStatusItem"}},"total":{"type":"integer","format":"int64","description":"Total number of payouts matching the time range.","example":1},"page":{"type":"integer","description":"Current page number.","example":1},"page_size":{"type":"integer","description":"Requested page size.","example":20},"total_pages":{"type":"integer","description":"Total number of pages.","example":1}}}}}]}},"components/schemas/Payout":{"id":"components/schemas/Payout","kind":"json-schema","title":"Payout","data":{"type":"object","required":["payout_id","client_reference_id","quote_id","provider","status","payout_type","source_currency","destination_currency","destination_country","amount_mode","fee_paid_by","sending_amount","receiving_amount","transfer_fee_amount","bank_fee_amount","fee_rate_decimal","rate","billing","destination","purpose_code","statement_reference","bank_reference","failure","return","is_duplicate","created_at","updated_at","completed_at"],"properties":{"payout_id":{"type":"string","description":"Infini fiat payout ID.","example":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX"},"client_reference_id":{"type":"string","description":"Merchant-provided payout reconciliation reference.","example":"payout_20260730_0001"},"quote_id":{"type":"string","description":"Quote used to create the payout.","example":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X"},"provider":{"type":"string","enum":["sgb"],"readOnly":true,"description":"Execution provider selected by Infini.","example":"sgb"},"status":{"type":"string","enum":["processing","completed","failed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current payout lifecycle state. A receiving-bank return does not change a completed payout's status; inspect the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object for the compensating refund. API payouts have no approval-pending state."},"children":[]}]}]}],"example":"processing"},"payout_type":{"type":"string","enum":["swift"],"description":"Payout rail bound by the quote.","example":"swift"},"source_currency":{"type":"string","enum":["USD"],"description":"Organization balance currency.","example":"USD"},"destination_currency":{"type":"string","enum":["USD"],"description":"Currency delivered to the recipient.","example":"USD"},"destination_country":{"type":"string","description":"Destination country as an ISO 3166-1 alpha-2 code.","example":"US"},"amount_mode":{"type":"string","enum":["send","receive"],"description":"Side fixed by the accepted quote.","example":"receive"},"fee_paid_by":{"type":"string","enum":["PAYER","BENEFICIARY"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Party responsible for payout fees. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means external deduction; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BENEFICIARY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means internal deduction. Persisted for statement reconciliation."},"children":[]}]}]}],"example":"PAYER"},"sending_amount":{"type":"string","description":"Actual total source-balance debit. This is also the authoritative outgoing statement amount.","example":"1051.05"},"receiving_amount":{"type":"string","description":"Amount delivered to the recipient.","example":"1000.00"},"transfer_fee_amount":{"type":"string","description":"Infini service fee frozen by the quote. It excludes any bank or rail fee.","example":"1.05"},"bank_fee_amount":{"type":"string","description":"Banking fee for the selected bank and payout rail frozen by the quote. Rail examples include SWIFT, ACH, and wire.","example":"50.00"},"fee_rate_decimal":{"type":"string","description":"Decimal transfer-fee rate frozen by the quote.","example":"0.001"},"rate":{"type":"string","description":"Exchange rate frozen by the quote.","example":"1"},"billing":{"$ref":"#/components/schemas/BillingBreakdown"},"destination":{"$ref":"#/components/schemas/BankDestinationView"},"purpose_code":{"type":"string","description":"Business purpose supplied at creation.","example":"goods_and_services"},"statement_reference":{"type":"string","nullable":true,"description":"Recipient-facing reference when supported.","example":"INV-2026-0730"},"bank_reference":{"type":"string","nullable":true,"description":"Bank transfer reference when available.","example":"RMTO2084957259539812352"},"failure":{"$ref":"#/components/schemas/Failure"},"return":{"$ref":"#/components/schemas/PayoutReturn"},"is_duplicate":{"type":"boolean","description":"Whether this response was produced by an idempotent create retry.","example":false},"created_at":{"type":"integer","format":"int64","description":"Payout creation time as Unix seconds.","example":1786587000},"updated_at":{"type":"integer","format":"int64","description":"Payout last-update time as Unix seconds.","example":1786587001},"completed_at":{"type":"integer","format":"int64","nullable":true,"description":"Time the banking partner reported payout completion, as Unix seconds.","example":1786587871}}}},"components/schemas/Failure":{"id":"components/schemas/Failure","kind":"json-schema","title":"Failure","data":{"type":"object","nullable":true,"description":"Failure details when the payout could not be completed; otherwise null.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable payout failure code.","example":"payout_failed"},"message":{"type":"string","description":"Human-readable payout failure details.","example":"The payout could not be completed"}}}},"components/schemas/PayoutReturn":{"id":"components/schemas/PayoutReturn","kind":"json-schema","title":"PayoutReturn","data":{"type":"object","nullable":true,"additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Compensating refund created after a receiving bank returns a completed payout; otherwise null. The original payout remains "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":["status","reason_code","reason","returned_amount","refund_amount","retained_fee","currency","returned_at"],"properties":{"status":{"type":"string","enum":["refunded"],"description":"Settlement state of the compensating refund.","example":"refunded"},"reason_code":{"type":"string","enum":["recipient_bank_rejected"],"description":"Stable machine-readable reason for the bank return.","example":"recipient_bank_rejected"},"reason":{"type":"string","description":"Human-readable bank-return reason when supplied by the banking partner.","example":"Beneficiary bank rejected the transfer"},"returned_amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$","description":"Amount the banking partner reported as returned.","example":"1000.00"},"refund_amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$","description":"Amount actually credited back to the organization's balance after retained fees.","example":"1000.00"},"retained_fee":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Original payout fee retained and not included in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refund_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"51.05"},"currency":{"type":"string","enum":["USD"],"description":"Currency of the return, refund, and retained-fee amounts.","example":"USD"},"returned_at":{"type":"integer","format":"int64","description":"Time the compensating refund was recorded, as Unix seconds.","example":1786674271}}}},"components/schemas/PayoutEnvelope":{"id":"components/schemas/PayoutEnvelope","kind":"json-schema","title":"PayoutEnvelope","data":{"allOf":[{"$ref":"#/components/schemas/StandardEnvelope"},{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Payout"}}}]}},"schema_70":{"kind":"json-schema","data":{"type":"string","example":"Tue, 30 Jul 2026 08:50:00 GMT"},"id":"schema_70"},"schema_71":{"kind":"json-schema","data":{"type":"string","example":"Signature keyId=\"key_example\",algorithm=\"hmac-sha256\",headers=\"@request-target date\",signature=\"<signature>\""},"id":"schema_71"},"schema_72":{"kind":"json-schema","data":{"type":"string","example":"SHA-256=<base64(sha256(request body))>"},"id":"schema_72"},"schema_73":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/ErrorEnvelope"},{"$ref":"#/components/schemas/GatewayError"}]},"id":"schema_73"},"schema_74":{"kind":"json-schema","data":{"type":"string","example":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX"},"id":"schema_74"}},"exampleStore":{"paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example":{"value":{"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"}}},"id":"paths/~1v2~1payouts~1quotes/post/requestBody/content/application~1json/example"},"paths/~1v2~1payouts~1quotes/post/responses/200/content/application~1json/example":{"value":{"code":0,"message":"","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.05","receiving_amount":"1000.00","transfer_fee_amount":"1.05","bank_fee_amount":"50.00","fee_rate_decimal":"0.001","rate":"1","billing":{"currency":"USD","transfer_fee":"1.05","fx_fee":"0.00","rail_fee":"50.00","total_fee":"51.05","fee_lines":[{"type":"transfer_fee","amount":"1.05","currency":"USD","rate":"0.001"},{"type":"rail_fee","amount":"50.00","currency":"USD","rate":"1"}]},"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}},"id":"paths/~1v2~1payouts~1quotes/post/responses/200/content/application~1json/example"},"paths/~1v2~1payouts~1quotes/post/responses/400/content/application~1json/example":{"value":{"code":30013,"message":"amount must be a positive decimal string","data":{"error":"invalid_parameter","field":"amount","retryable":false}},"id":"paths/~1v2~1payouts~1quotes/post/responses/400/content/application~1json/example"},"paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed":{"value":{"message":"client request can't be validated"},"key":"gatewayAuthenticationFailed","summary":"Gateway could not validate the signed request","id":"paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed"},"paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed":{"value":{"code":401,"message":"Unauthorized","data":{"error":"authentication_failed","field":null,"retryable":false}},"key":"applicationAuthenticationFailed","summary":"Application authentication context is invalid","id":"paths/~1v2~1payouts~1quotes/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"},"paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/permissionDenied":{"value":{"code":403,"message":"Payout access is denied","data":{"error":"permission_denied","field":null,"retryable":false}},"key":"permissionDenied","summary":"Payout access denied by permission or network policy","id":"paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/permissionDenied"},"paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound":{"value":{"code":108010,"message":"USD payout account is not available for this organization","data":{"error":"payout_source_account_not_found","field":null,"retryable":false}},"key":"payoutSourceAccountNotFound","summary":"Organization does not have a USD payout account","id":"paths/~1v2~1payouts~1quotes/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"},"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/idempotencyConflict":{"value":{"code":108012,"message":"client_reference_id was already used for a different request","data":{"error":"idempotency_conflict","field":"client_reference_id","retryable":false}},"key":"idempotencyConflict","summary":"Idempotency reference reused with different request data","id":"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/idempotencyConflict"},"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteAlreadyUsed":{"value":{"code":108013,"message":"Quote has already been used","data":{"error":"quote_already_used","field":"quote_id","retryable":false}},"key":"quoteAlreadyUsed","summary":"Quote has already been consumed","id":"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteAlreadyUsed"},"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteNotActive":{"value":{"code":108014,"message":"Quote is not active","data":{"error":"quote_not_active","field":"quote_id","retryable":false}},"key":"quoteNotActive","summary":"Quote is not active","id":"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/quoteNotActive"},"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/submissionInProgress":{"value":{"code":108015,"message":"Another payout submission is in progress. Please retry shortly.","data":{"error":"payout_submission_in_progress","field":null,"retryable":true}},"key":"submissionInProgress","summary":"Another payout submission is in progress for the organization","id":"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/submissionInProgress"},"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid":{"value":{"code":108011,"message":"USD payout account configuration is invalid. Contact support.","data":{"error":"payout_source_account_invalid","field":null,"retryable":false}},"key":"payoutSourceAccountInvalid","summary":"USD payout account configuration is inconsistent","id":"paths/~1v2~1payouts~1quotes/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/invalidFeeMode":{"value":{"code":108001,"message":"amount_mode and fee_paid_by are not supported together","data":{"error":"invalid_fee_mode","field":"fee_paid_by","retryable":false}},"key":"invalidFeeMode","summary":"Invalid fee mode","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/invalidFeeMode"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteExpired":{"value":{"code":108002,"message":"Quote has expired","data":{"error":"quote_expired","field":"quote_id","retryable":true}},"key":"quoteExpired","summary":"Quote expired","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteExpired"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteUnavailable":{"value":{"code":108003,"message":"Payout quote is temporarily unavailable","data":{"error":"quote_unavailable","field":null,"retryable":true}},"key":"quoteUnavailable","summary":"Quote is temporarily unavailable","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/quoteUnavailable"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountExceedsLimit":{"value":{"code":108004,"message":"Payout amount exceeds the supported limit","data":{"error":"amount_exceeds_limit","field":"amount","retryable":false}},"key":"amountExceedsLimit","summary":"Amount exceeds the supported limit","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountExceedsLimit"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountTooSmall":{"value":{"code":108005,"message":"Payout sending amount must be greater than 100 USD","data":{"error":"amount_too_small","field":"amount","retryable":false}},"key":"amountTooSmall","summary":"Amount is below the supported minimum","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/amountTooSmall"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/insufficientBalance":{"value":{"code":108006,"message":"Insufficient payout balance","data":{"error":"insufficient_balance","field":"amount","retryable":false}},"key":"insufficientBalance","summary":"Insufficient balance","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/insufficientBalance"},"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/dailyLimitExceeded":{"value":{"code":108007,"message":"Payout would exceed the account's daily withdrawal limit","data":{"error":"daily_limit_exceeded","field":"amount","retryable":false}},"key":"dailyLimitExceeded","summary":"Amount would exceed the account's shared daily withdrawal limit","id":"paths/~1v2~1payouts~1quotes/post/responses/422/content/application~1json/examples/dailyLimitExceeded"},"paths/~1v2~1payouts~1quotes/post/responses/500/content/application~1json/example":{"value":{"code":500,"message":"An error occurred internally","data":{"error":"internal_error","field":null,"retryable":true}},"id":"paths/~1v2~1payouts~1quotes/post/responses/500/content/application~1json/example"},"paths/~1v2~1payouts/post/requestBody/content/application~1json/example":{"value":{"client_reference_id":"payout_20260730_0001","quote_id":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X","purpose_code":"goods_and_services","statement_reference":"INV-2026-0730"},"id":"paths/~1v2~1payouts/post/requestBody/content/application~1json/example"},"paths/~1v2~1payouts/post/responses/200/content/application~1json/example":{"value":{"code":0,"message":"","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.05","receiving_amount":"1000.00","transfer_fee_amount":"1.05","bank_fee_amount":"50.00","fee_rate_decimal":"0.001","rate":"1","billing":{"currency":"USD","transfer_fee":"1.05","fx_fee":"0.00","rail_fee":"50.00","total_fee":"51.05","fee_lines":[{"type":"transfer_fee","amount":"1.05","currency":"USD","rate":"0.001"},{"type":"rail_fee","amount":"50.00","currency":"USD","rate":"1"}]},"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":null,"failure":null,"return":null,"is_duplicate":false,"created_at":1786587000,"updated_at":1786587001,"completed_at":null}},"id":"paths/~1v2~1payouts/post/responses/200/content/application~1json/example"},"paths/~1v2~1payouts/post/responses/400/content/application~1json/example":{"value":{"code":30013,"message":"amount must be a positive decimal string","data":{"error":"invalid_parameter","field":"amount","retryable":false}},"id":"paths/~1v2~1payouts/post/responses/400/content/application~1json/example"},"paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed":{"value":{"message":"client request can't be validated"},"key":"gatewayAuthenticationFailed","summary":"Gateway could not validate the signed request","id":"paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed"},"paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed":{"value":{"code":401,"message":"Unauthorized","data":{"error":"authentication_failed","field":null,"retryable":false}},"key":"applicationAuthenticationFailed","summary":"Application authentication context is invalid","id":"paths/~1v2~1payouts/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"},"paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/permissionDenied":{"value":{"code":403,"message":"Payout access is denied","data":{"error":"permission_denied","field":null,"retryable":false}},"key":"permissionDenied","summary":"Payout access denied by permission or network policy","id":"paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/permissionDenied"},"paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound":{"value":{"code":108010,"message":"USD payout account is not available for this organization","data":{"error":"payout_source_account_not_found","field":null,"retryable":false}},"key":"payoutSourceAccountNotFound","summary":"Organization does not have a USD payout account","id":"paths/~1v2~1payouts/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"},"paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/payoutNotFound":{"value":{"code":404,"message":"Payout does not exist","data":{"error":"resource_not_found","field":"payout_id","retryable":false}},"key":"payoutNotFound","summary":"Payout does not exist for the authenticated organization","id":"paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/payoutNotFound"},"paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/quoteNotFound":{"value":{"code":404,"message":"Quote does not exist","data":{"error":"resource_not_found","field":"quote_id","retryable":false}},"key":"quoteNotFound","summary":"Quote does not exist for the authenticated organization","id":"paths/~1v2~1payouts/post/responses/404/content/application~1json/examples/quoteNotFound"},"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/idempotencyConflict":{"value":{"code":108012,"message":"client_reference_id was already used for a different request","data":{"error":"idempotency_conflict","field":"client_reference_id","retryable":false}},"key":"idempotencyConflict","summary":"Idempotency reference reused with different request data","id":"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/idempotencyConflict"},"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteAlreadyUsed":{"value":{"code":108013,"message":"Quote has already been used","data":{"error":"quote_already_used","field":"quote_id","retryable":false}},"key":"quoteAlreadyUsed","summary":"Quote has already been consumed","id":"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteAlreadyUsed"},"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteNotActive":{"value":{"code":108014,"message":"Quote is not active","data":{"error":"quote_not_active","field":"quote_id","retryable":false}},"key":"quoteNotActive","summary":"Quote is not active","id":"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/quoteNotActive"},"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/submissionInProgress":{"value":{"code":108015,"message":"Another payout submission is in progress. Please retry shortly.","data":{"error":"payout_submission_in_progress","field":null,"retryable":true}},"key":"submissionInProgress","summary":"Another payout submission is in progress for the organization","id":"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/submissionInProgress"},"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid":{"value":{"code":108011,"message":"USD payout account configuration is invalid. Contact support.","data":{"error":"payout_source_account_invalid","field":null,"retryable":false}},"key":"payoutSourceAccountInvalid","summary":"USD payout account configuration is inconsistent","id":"paths/~1v2~1payouts/post/responses/409/content/application~1json/examples/payoutSourceAccountInvalid"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/invalidFeeMode":{"value":{"code":108001,"message":"amount_mode and fee_paid_by are not supported together","data":{"error":"invalid_fee_mode","field":"fee_paid_by","retryable":false}},"key":"invalidFeeMode","summary":"Invalid fee mode","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/invalidFeeMode"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteExpired":{"value":{"code":108002,"message":"Quote has expired","data":{"error":"quote_expired","field":"quote_id","retryable":true}},"key":"quoteExpired","summary":"Quote expired","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteExpired"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteUnavailable":{"value":{"code":108003,"message":"Payout quote is temporarily unavailable","data":{"error":"quote_unavailable","field":null,"retryable":true}},"key":"quoteUnavailable","summary":"Quote is temporarily unavailable","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/quoteUnavailable"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountExceedsLimit":{"value":{"code":108004,"message":"Payout amount exceeds the supported limit","data":{"error":"amount_exceeds_limit","field":"amount","retryable":false}},"key":"amountExceedsLimit","summary":"Amount exceeds the supported limit","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountExceedsLimit"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountTooSmall":{"value":{"code":108005,"message":"Payout sending amount must be greater than 100 USD","data":{"error":"amount_too_small","field":"amount","retryable":false}},"key":"amountTooSmall","summary":"Amount is below the supported minimum","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/amountTooSmall"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/insufficientBalance":{"value":{"code":108006,"message":"Insufficient payout balance","data":{"error":"insufficient_balance","field":"amount","retryable":false}},"key":"insufficientBalance","summary":"Insufficient balance","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/insufficientBalance"},"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/dailyLimitExceeded":{"value":{"code":108007,"message":"Payout would exceed the account's daily withdrawal limit","data":{"error":"daily_limit_exceeded","field":"amount","retryable":false}},"key":"dailyLimitExceeded","summary":"Amount would exceed the account's shared daily withdrawal limit","id":"paths/~1v2~1payouts/post/responses/422/content/application~1json/examples/dailyLimitExceeded"},"paths/~1v2~1payouts/post/responses/500/content/application~1json/example":{"value":{"code":500,"message":"An error occurred internally","data":{"error":"internal_error","field":null,"retryable":true}},"id":"paths/~1v2~1payouts/post/responses/500/content/application~1json/example"},"paths/~1v2~1payouts/post/responses/503/content/application~1json/example":{"value":{"code":108009,"message":"Payout service is temporarily unavailable. Please try again later.","data":{"error":"payout_service_unavailable","field":null,"retryable":true}},"id":"paths/~1v2~1payouts/post/responses/503/content/application~1json/example"},"paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example":{"value":{"start_time":1786500000,"end_time":1786599999,"page":1,"page_size":20},"id":"paths/~1v2~1payouts~1status~1batch/post/requestBody/content/application~1json/example"},"paths/~1v2~1payouts~1status~1batch/post/responses/200/content/application~1json/example":{"value":{"code":0,"message":"","data":{"payouts":[{"payout_id":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX","client_reference_id":"payout_20260730_0001","quote_id":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X","provider":"sgb","status":"completed","payout_type":"swift","source_currency":"USD","destination_currency":"USD","destination_country":"US","amount_mode":"receive","fee_paid_by":"PAYER","sending_amount":"1051.05","receiving_amount":"1000.00","transfer_fee_amount":"1.05","bank_fee_amount":"50.00","fee_rate_decimal":"0.001","rate":"1","billing":{"currency":"USD","transfer_fee":"1.05","fx_fee":"0.00","rail_fee":"50.00","total_fee":"51.05","fee_lines":[{"type":"transfer_fee","amount":"1.05","currency":"USD","rate":"0.001"},{"type":"rail_fee","amount":"50.00","currency":"USD","rate":"1"}]},"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":null,"return":null,"created_at":1786587000,"updated_at":1786587871,"completed_at":1786587871}],"total":1,"page":1,"page_size":20,"total_pages":1}},"id":"paths/~1v2~1payouts~1status~1batch/post/responses/200/content/application~1json/example"},"paths/~1v2~1payouts~1status~1batch/post/responses/400/content/application~1json/example":{"value":{"code":30013,"message":"amount must be a positive decimal string","data":{"error":"invalid_parameter","field":"amount","retryable":false}},"id":"paths/~1v2~1payouts~1status~1batch/post/responses/400/content/application~1json/example"},"paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed":{"value":{"message":"client request can't be validated"},"key":"gatewayAuthenticationFailed","summary":"Gateway could not validate the signed request","id":"paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/gatewayAuthenticationFailed"},"paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed":{"value":{"code":401,"message":"Unauthorized","data":{"error":"authentication_failed","field":null,"retryable":false}},"key":"applicationAuthenticationFailed","summary":"Application authentication context is invalid","id":"paths/~1v2~1payouts~1status~1batch/post/responses/401/content/application~1json/examples/applicationAuthenticationFailed"},"paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/permissionDenied":{"value":{"code":403,"message":"Payout access is denied","data":{"error":"permission_denied","field":null,"retryable":false}},"key":"permissionDenied","summary":"Payout access denied by permission or network policy","id":"paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/permissionDenied"},"paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound":{"value":{"code":108010,"message":"USD payout account is not available for this organization","data":{"error":"payout_source_account_not_found","field":null,"retryable":false}},"key":"payoutSourceAccountNotFound","summary":"Organization does not have a USD payout account","id":"paths/~1v2~1payouts~1status~1batch/post/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"},"paths/~1v2~1payouts~1status~1batch/post/responses/500/content/application~1json/example":{"value":{"code":500,"message":"An error occurred internally","data":{"error":"internal_error","field":null,"retryable":true}},"id":"paths/~1v2~1payouts~1status~1batch/post/responses/500/content/application~1json/example"},"paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/processing":{"value":{"code":0,"message":"","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.05","receiving_amount":"1000.00","transfer_fee_amount":"1.05","bank_fee_amount":"50.00","fee_rate_decimal":"0.001","rate":"1","billing":{"currency":"USD","transfer_fee":"1.05","fx_fee":"0.00","rail_fee":"50.00","total_fee":"51.05","fee_lines":[{"type":"transfer_fee","amount":"1.05","currency":"USD","rate":"0.001"},{"type":"rail_fee","amount":"50.00","currency":"USD","rate":"1"}]},"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":null,"failure":null,"return":null,"is_duplicate":false,"created_at":1786587000,"updated_at":1786587001,"completed_at":null}},"key":"processing","summary":"Processing payout","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/processing"},"paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/completed":{"value":{"code":0,"message":"","data":{"payout_id":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX","client_reference_id":"payout_20260730_0001","quote_id":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X","provider":"sgb","status":"completed","payout_type":"swift","source_currency":"USD","destination_currency":"USD","destination_country":"US","amount_mode":"receive","fee_paid_by":"PAYER","sending_amount":"1051.05","receiving_amount":"1000.00","transfer_fee_amount":"1.05","bank_fee_amount":"50.00","fee_rate_decimal":"0.001","rate":"1","billing":{"currency":"USD","transfer_fee":"1.05","fx_fee":"0.00","rail_fee":"50.00","total_fee":"51.05","fee_lines":[{"type":"transfer_fee","amount":"1.05","currency":"USD","rate":"0.001"},{"type":"rail_fee","amount":"50.00","currency":"USD","rate":"1"}]},"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":null,"return":null,"is_duplicate":false,"created_at":1786587000,"updated_at":1786587871,"completed_at":1786587871}},"key":"completed","summary":"Completed payout","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/completed"},"paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/bank_returned":{"value":{"code":0,"message":"","data":{"payout_id":"fpo_01JQ90GQJTC5P7B2D8N6R4K1MX","client_reference_id":"payout_20260730_0001","quote_id":"poq_01JQ90B8S5VJ6R3T7F1M2C4N9X","provider":"sgb","status":"completed","payout_type":"swift","source_currency":"USD","destination_currency":"USD","destination_country":"US","amount_mode":"receive","fee_paid_by":"PAYER","sending_amount":"1051.05","receiving_amount":"1000.00","transfer_fee_amount":"1.05","bank_fee_amount":"50.00","fee_rate_decimal":"0.001","rate":"1","billing":{"currency":"USD","transfer_fee":"1.05","fx_fee":"0.00","rail_fee":"50.00","total_fee":"51.05","fee_lines":[{"type":"transfer_fee","amount":"1.05","currency":"USD","rate":"0.001"},{"type":"rail_fee","amount":"50.00","currency":"USD","rate":"1"}]},"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":null,"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.05","currency":"USD","returned_at":1786674271},"is_duplicate":false,"created_at":1786587000,"updated_at":1786674271,"completed_at":1786587871}},"key":"bank_returned","summary":"Completed payout later returned by the receiving bank","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/200/content/application~1json/examples/bank_returned"},"paths/~1v2~1payouts~1{payout_id}/get/responses/400/content/application~1json/example":{"value":{"code":30013,"message":"amount must be a positive decimal string","data":{"error":"invalid_parameter","field":"amount","retryable":false}},"id":"paths/~1v2~1payouts~1{payout_id}/get/responses/400/content/application~1json/example"},"paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/gatewayAuthenticationFailed":{"value":{"message":"client request can't be validated"},"key":"gatewayAuthenticationFailed","summary":"Gateway could not validate the signed request","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/gatewayAuthenticationFailed"},"paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/applicationAuthenticationFailed":{"value":{"code":401,"message":"Unauthorized","data":{"error":"authentication_failed","field":null,"retryable":false}},"key":"applicationAuthenticationFailed","summary":"Application authentication context is invalid","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/401/content/application~1json/examples/applicationAuthenticationFailed"},"paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/permissionDenied":{"value":{"code":403,"message":"Payout access is denied","data":{"error":"permission_denied","field":null,"retryable":false}},"key":"permissionDenied","summary":"Payout access denied by permission or network policy","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/permissionDenied"},"paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/payoutSourceAccountNotFound":{"value":{"code":108010,"message":"USD payout account is not available for this organization","data":{"error":"payout_source_account_not_found","field":null,"retryable":false}},"key":"payoutSourceAccountNotFound","summary":"Organization does not have a USD payout account","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/403/content/application~1json/examples/payoutSourceAccountNotFound"},"paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/payoutNotFound":{"value":{"code":404,"message":"Payout does not exist","data":{"error":"resource_not_found","field":"payout_id","retryable":false}},"key":"payoutNotFound","summary":"Payout does not exist for the authenticated organization","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/payoutNotFound"},"paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/quoteNotFound":{"value":{"code":404,"message":"Quote does not exist","data":{"error":"resource_not_found","field":"quote_id","retryable":false}},"key":"quoteNotFound","summary":"Quote does not exist for the authenticated organization","id":"paths/~1v2~1payouts~1{payout_id}/get/responses/404/content/application~1json/examples/quoteNotFound"},"paths/~1v2~1payouts~1{payout_id}/get/responses/500/content/application~1json/example":{"value":{"code":500,"message":"An error occurred internally","data":{"error":"internal_error","field":null,"retryable":true}},"id":"paths/~1v2~1payouts~1{payout_id}/get/responses/500/content/application~1json/example"}},"securitySchemeStore":{"InfiniHmac":{"id":"InfiniHmac","type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sandbox API "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (keyId) and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the Infini dashboard."},"children":[]}]}]}]}},"servers":[{"url":"/_mock/apis/payout","isMockServer":true,"description":"Mock server"},{"url":"https://openapi.infini.money","description":"Production"},{"url":"https://openapi-sandbox.infini.money","description":"Sandbox"}]},"options":{"hideReplay":false,"corsProxyUrl":"https://infini-hmac-cors-proxy.infini-labs.workers.dev/_api/cors/","hideSidebar":true,"mockServer":{"url":"/_mock/apis/payout","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/apis/payout.json?download"},{"url":"/_bundle/apis/payout.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Infini Fiat Payout API","description":"The Fiat Payout API lets an organization quote, create, and query direct USD bank payouts from its Infini USD balance to a third-party bank account.\n\nAll endpoints use the `/v2/payouts` prefix. Requests require [HMAC-SHA256 authentication](/docs/en/4-authorization) and an API key with the relevant payout permission.\n\n`POST /v2/payouts` does not enter the dashboard approval workflow. Infini performs final authorization, compliance, quote, destination, limit, and available-balance checks and then starts payout execution immediately. Bank settlement is asynchronous, so a successful create response normally has `status=processing`; it does not guarantee that the receiving bank account has already been credited."}},"baseSlug":"/apis/payout","routesMapping":{}}