Fiat payout beneficiary status change

{ "subscriptionId": "00000000-0000-4000-8000-000000000002", "notificationId": "11111111-1111-4111-8111-111111111131", "notificationType": "payouts.beneficiary.updated", "notification": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "customerType": "INDIVIDUAL", "destinationCountry": "MX", "destinationCurrency": "MXN", "paymentMethod": "SPEI", "status": "ACTIVE", "riskDecision": "ACTIVE", "riskScreenedDate": "2026-08-25T19:31:20.000Z", "fieldManifest": "[\"BENEFICIARY_ADDRESS\",\"BENEFICIARY_NAME\",\"CLABE\"]", "createDate": "2026-08-25T19:30:45.123Z", "updateDate": "2026-08-25T19:31:20.000Z" }, "timestamp": "2026-08-25T19:31:21.000000000Z", "version": 2 }

Body

application/json

The envelope every v2 webhook notification arrives in. The product-specific fields live in notification.

subscriptionId

string<uuid>

required

ID of the webhook subscription that produced this notification.

notificationId

string<uuid>

required

Unique ID for this event. Stable across retries of the same delivery, so use it to deduplicate.

notificationType

enum<string>

required

The type of notification.

Available options:

payouts.beneficiary.updated

notification

object

required

The event payload. The schema of this object depends on notificationType.

Show child attributes

timestamp

string<date-time>

required

When the notification was produced.

version

integer

required

The version of the notification schema. Always 2.

Response

200

Webhook received successfully

API overview

Fiat payouts

Managed Payments

Stablecoin payments

Circle Payments Network

Fiat payout beneficiary status change

Body

Response