Create a fiat settlement
apiKeyApi-Key<token>Partner API key.
merchantId*stringIdempotency-Key*stringUnique key to ensure idempotent request processing. Max 255 characters.
length <= 255application/json- body
bankDetails*|Bank account that will receive fiat settlements. bankType discriminates the schema: SEPA requires iban; ACH requires accountNumber, routingNumber, and phoneNumber. Currency is implicit — SEPA settles in EUR, ACH in USD.
businessDetails*Business identity details collected for KYB verification.
Fiat settlement created. The merchant must complete KYB at kybUrl to activate routing.
application/json- response
id*stringFiat settlement ID. Stable identifier — safe to persist on the partner side.
status*stringFiat settlement status. pending_kyb immediately after creation — the merchant must complete KYB at kybUrl before payments can route to this account. Transitions to active on KYB approval; rejected if KYB fails.
kybUrl*|URL the merchant must visit to complete KYB verification. Returned at creation; treat as short-lived (hours to days). null only when no merchant action is pending.
curl -X POST 'https://api.merchant.pay.walletconnect.com/v1/merchants/string/settlements/fiat' \ -H 'Idempotency-Key: string' \ -H 'Content-Type: application/json' \ -d '{ "bankDetails": { "accountHolderName": "Acme Corp Inc", "bankName": "Chase", "bankCountry": "st", "bankType": "SEPA", "iban": "FR1420041010050500013M02606" }, "businessDetails": { "businessName": "Acme Corp Inc", "address": { "line1": "350 Fifth Avenue", "city": "New York", "state": "NY", "country": "st", "zip": "10118" } }}'{ "id": "fiat_Bk4nWp8XmQj2YrTv6", "status": "pending_kyb", "kybUrl": "https://kyb.iron.io/verify/abc123"}