Skip to main content
PUT
Update a payment method

Authorizations

Authorization
string
header
required

Merchant authentication token. Obtained via POST /api/v1/merchant/token/grant. Pass as: Authorization: Bearer

Path Parameters

customer_id
string<uuid>
required
id
string<uuid>
required

Body

application/json

Create a payment method for a customer. Fields type, provider, currency, chain, and bank_account_type are case-insensitive.

type
enum<string>
required

Payment method type (case-insensitive)

Available options:
bank,
card,
pix,
customer_wallet,
liquidation_address
provider
string

Provider name (defaults to crowd_split for bank/pix/customer_wallet)

currency
string

Currency code

source_currency
string
destination_currency
string
payment_rail
string
bank_account_type
enum<string>
Available options:
checking,
savings,
payment
chain
string

Blockchain chain

external_account_id
string

Required for liquidation_address type

bank_details
object

Required for bank type

Response

Payment method updated

msg
string
required

Human-readable message describing the result

data
object
required

Response payload (null on error)