Update Payment Destination

{
  "is_default": true
}

{
  "object": "payment_destination",
  "id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
  "beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
  "country": "GB",
  "type": "bank_account",
  "currency": "GBP",
  "status": "active",
  "account_number_last4": "****6819",
  "iban_masked": "GB29****6819",
  "is_default": true,
  "created": "2026-05-01T10:05:00Z",
  "updated": "2026-05-10T14:30:00Z",
  "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
  "updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
}

PATCH

ads

accounts

{account_id}

beneficiaries

{beneficiary_id}

payment-destinations

{id}

{
  "is_default": true
}

{
  "object": "payment_destination",
  "id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
  "beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
  "country": "GB",
  "type": "bank_account",
  "currency": "GBP",
  "status": "active",
  "account_number_last4": "****6819",
  "iban_masked": "GB29****6819",
  "is_default": true,
  "created": "2026-05-01T10:05:00Z",
  "updated": "2026-05-10T14:30:00Z",
  "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
  "updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
}

Updates a payment destination. Only the is_default flag is client-editable — all financial fields (account numbers, IBAN, SWIFT, etc.) are immutable after creation. To change account details, create a new destination and disable the old one.

Fields other than is_default are ignored or rejected. Financial details cannot be edited in place.

Path Parameters

string

required

Id of the parent account (e.g. acct_...).

string

required

Id of the parent beneficiary (e.g. bene_...).

string

required

Destination id (e.g. dest_…).

Request Body

boolean | null

Set to true to make this the beneficiary’s default destination.

Response

Returns the updated payment_destination object.

{
  "is_default": true
}

{
  "object": "payment_destination",
  "id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
  "beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
  "country": "GB",
  "type": "bank_account",
  "currency": "GBP",
  "status": "active",
  "account_number_last4": "****6819",
  "iban_masked": "GB29****6819",
  "is_default": true,
  "created": "2026-05-01T10:05:00Z",
  "updated": "2026-05-10T14:30:00Z",
  "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
  "updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
}

Get Payment Destination Disable Payment Destination

Getting Started

Integration Flows

Webhooks

Endpoints

Update Payment Destination

Path Parameters

Request Body

Response

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response