Skip to main content
PUT
/
api
/
v1
/
customers
/
{customer_id}
/
payment_methods
/
{id}
Update a payment method
curl --request PUT \
  --url https://payments.oaknetwork.org/api/v1/customers/{customer_id}/payment_methods/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "<string>",
  "currency": "<string>",
  "source_currency": "<string>",
  "destination_currency": "<string>",
  "payment_rail": "<string>",
  "chain": "<string>",
  "external_account_id": "<string>",
  "bank_details": {
    "pix_string": "<string>",
    "branch_code": "<string>",
    "account_number": "<string>",
    "account_name": "<string>",
    "bank_name": "<string>",
    "bank_code": "<string>",
    "ispb": "<string>",
    "country": "<string>",
    "routing_number": "<string>"
  }
}
'
{
  "msg": "<string>",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "<string>",
    "status": "<string>",
    "provider": "<string>",
    "chain": "<string>",
    "currency": "<string>",
    "source_currency": "<string>",
    "destination_currency": "<string>",
    "bank_account_type": "<string>",
    "bankDetails": {
      "accountNumber": "<string>",
      "accountName": "<string>",
      "accountType": "<string>",
      "bankName": "<string>",
      "branchCode": "<string>",
      "ispb": "<string>"
    }
  }
}

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)