Skip to main content
POST
/
admin
/
sellers
/
{id}
/
payment-details
curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/payment-details' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "country_code": "de",
    "holder_name": "Acme GmbH",
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX"
  }'

{
  "seller": {
    "id": "sel_01HXYZABCDEF",
    "name": "Acme",
    "status": "open",
    "payment_details": {
      "country_code": "de",
      "holder_name": "Acme GmbH",
      "bank_name": null,
      "iban": "DE89370400440532013000",
      "bic": "COBADEFFXXX"
    },
    "updated_at": "2026-06-12T11:00:00.000Z"
  }
}
Creates the seller’s payment details if none exist, otherwise updates them.

​
Path parameters

​
id
string
required
The seller’s ID.

​
Query parameters

​
fields
string
Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.

​
Body parameters

​
country_code
string
Two-letter ISO country code of the bank account.
​
holder_name
string
Name of the account holder.
​
bank_name
string
Name of the bank.
​
iban
string
IBAN of the account.
​
bic
string
BIC / SWIFT code.
​
routing_number
string
Routing number for US accounts.
​
account_number
string
Account number.
​
additional_data
object
Extra data passed to workflow hooks.

​
Response

​
seller
object
curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/payment-details' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "country_code": "de",
    "holder_name": "Acme GmbH",
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX"
  }'

{
  "seller": {
    "id": "sel_01HXYZABCDEF",
    "name": "Acme",
    "status": "open",
    "payment_details": {
      "country_code": "de",
      "holder_name": "Acme GmbH",
      "bank_name": null,
      "iban": "DE89370400440532013000",
      "bic": "COBADEFFXXX"
    },
    "updated_at": "2026-06-12T11:00:00.000Z"
  }
}