Update Fiat Payee
PUT
/api/v1/payees/fiat
Last modified:2026-07-16 12:48:45
id in the body along with the fields to change.PayeeFiat payload is large; the key field groups are:| Field | Type | Description | Constraints |
|---|---|---|---|
id | string (uuid) | Payee identifier (required for update, omit on create) | - |
favouriteName | string | Display name for the payee | Nullable |
accountType | string | individual or business | Nullable |
firstName / lastName | string | Individual payee name | Max: 100 · Nullable |
middleName | string | Individual middle name | Nullable |
businessName | string | Business payee name | Nullable |
businessRegistrationNumber | string | Business registration no. | Nullable |
businessType | string | Business type | Nullable |
email | string | Payee email | Max: 100 · Nullable |
phoneCode / phoneNumber | string | Payee phone | Nullable |
dateOfBirth | string | Date of birth | Nullable |
relationCode / relation | string | Relationship to sender | Nullable |
| Field | Type | Description |
|---|---|---|
line1 / street | string | Street address |
country / state / city / postalCode | string | Address components |
| Field | Type | Description |
|---|---|---|
currency | string | Payout currency code |
bankName / bankCountry / bankBranch | string | Bank identity |
accountNumber / iban | string | Account identifiers |
swiftOrBicCode / bic / swiftBIC | string | SWIFT/BIC |
ifscCode / sortCode / routeNumber / abaRoutingCode / bsbNumber / clearingNumber / branchCode | string | Region-specific bank codes |
bankAccountType / paymentAccountType | string | Account type |
paymentType / transferType / paymentSchema | string | Payment routing config |
purpose / paymentPurpose / remittancePurpose | string | Purpose of payments |
| Field | Type | Description |
|---|---|---|
documentType / documentNumber | string | Identity document |
proofType | string | Proof of relationship/ownership |
frontImage / backImage | object | { name, url } document images |
customerId, holderName, fullName, walletType, walletSource, whiteListState, whiteListRemarks, stableCoinPayout, isOnTheGo, bankAddress, bankCity, bankPostalCode, providerBankCode, bankCode, ukShortCode, metadata, paymentInfo.Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/api/v1/payees/fiat' \
--header 'X-Idempotency-Key: b7e6a1f0-2c3d-4e5f-8a9b-0c1d2e3f4a5b' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "9b2f1c44-8a31-4f0d-9d6e-1c2b3a4d5e6f",
"favouriteName": "John'\''s US Account",
"accountType": "individual",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"phoneCode": "+1",
"phoneNumber": "5551234567",
"dateOfBirth": "1988-04-12",
"relationCode": "FRIEND",
"line1": "221 Market Street",
"city": "San Francisco",
"state": "CA",
"country": "US",
"postalCode": "94105",
"currency": "USD",
"bankName": "Chase Bank",
"bankCountry": "US",
"accountNumber": "000123456789",
"abaRoutingCode": "021000021",
"bankAccountType": "checking",
"paymentType": "bank",
"transferType": "LOCAL",
"purpose": "Family Support",
"documentType": "passport",
"documentNumber": "N1234567",
"proofType": "bank_statement",
"frontImage": {
"name": "passport-front.jpg",
"url": "https://files.example.com/passport-front.jpg"
},
"backImage": {
"name": "passport-back.jpg",
"url": "https://files.example.com/passport-back.jpg"
}
}'Response Response Example
{
"id": "9b2f1c44-8a31-4f0d-9d6e-1c2b3a4d5e6f",
"status": "pending",
"modifiedDate": "2026-07-16T11:05:00Z"
}Modified at 2026-07-16 12:48:45