Payloads and Examples - Yuno API Documentation

Webhook attributes

The JSON attributes for Yuno webhooks are listed below. See Events and Triggers for the trigger field that selects each event.

string

The unique identifier of the account in Yuno (MAX 64, MIN 36).

string

Specifies the notification type.

string

Specifies the event notification type.

string

Specifies the version of the webhook sent. Currently 2.

string

Specifies the number of retries for that notification.

object

Specifies the payment (for payment type) or payment method object (for enrollment and other objects).

Show properties

string

Identifier used to skip duplicate deliveries. It stays stable across every retry of the same event. The location depends on the event: ordinary payment events (including refund and chargeback) carry it at data.payment.idempotency_key, payment.split_update carries it at data.split_update.idempotency_key, and subscription events carry it at data.idempotency_key. On subscription.* events it identifies the subscription rather than the event, so de-duplicate those on type_event plus this key. See De-duplication for coverage details.

string

Optional. The HMAC-SHA256 signature sent in the HTTP header for webhook verification when HMAC authentication is enabled.

Split update webhooks

These abbreviated examples show only the fields needed to interpret payment.split_update; the normal payment fields are also included. This event requires explicit subscription and is pending production catalog availability. In v2, the envelope identifies type_event: "payment.split_update", and the operation block is data.split_update:

{
  "type": "payment",
  "type_event": "payment.split_update",
  "version": 2,
  "retry": 0,
  "data": {
    "split_update": {
      "idempotency_key": "4a518553-a6e7-4717-a415-06084ea85c99",
      "updated_at": "2026-09-22T04:20:00Z"
    },
    "payment": {
      "transactions": {
        "split_marketplace": []
      }
    }
  }
}

This example clears the split, so the operation’s split_marketplace is []. An applied replacement carries that operation’s split entries instead. transactions is a single object, not an array. Legacy v1 sends the payment body without the v2 envelope or type_event. Identify this event by the split_update block next to payment:

{
  "split_update": {
    "idempotency_key": "4a518553-a6e7-4717-a415-06084ea85c99",
    "updated_at": "2026-09-22T04:20:00Z"
  },
  "payment": {
    "transactions": {
      "split_marketplace": []
    }
  }
}

Field	Meaning
`split_update.idempotency_key`	The original split update request key. Use it to distinguish operations and de-duplicate delivery, scoped by account and event type.
`split_update.updated_at`	The operation’s recorded completion time, preserved on repeated resolution and delayed notification.
`payment.transactions.split_marketplace`	The selected operation’s split snapshot, including `[]` for a clear.

If transactions_history is enabled, its entry for the affected transaction carries the same operation split. The event does not enable history or replace the payment-level payment.split_marketplace; do not use that payment-level field as this operation’s snapshot. Other fields reflect the payment read when the notification is prepared and may include later changes. Use GET /v1/payments/{payment_id} for the latest payment state. The operation snapshot is not guaranteed to serialize identically to a later payment read. Numeric scale can differ (for example, 5 versus 5.0), and a liability object containing only chargebacks can be represented differently by the live-payment mapping. Compare values and their meaning rather than requiring byte-for-byte JSON equality. These representation differences do not identify a new split operation. Only this event adds split_update; purchase and refund payloads do not acquire the block. See Split update notifications for subscription, emission, ordering, and delivery behavior.

Examples

Yuno provides several webhooks related to enrollment and payment notifications. Here you will find some examples of data structures related to each event.

Payment Webhook V2

Payment Webhook V1

Chargeback Webhook V2

Chargeback Webhook V1

Enrollment

Payouts

Subscriptions

Onboardings

Refunds

Marketplace Split Transfers

HMAC - Authorization

Payment

Payment Webhook V2

Example payload:

Webhook payloads for events corresponding to a bank transfer payment method include payment.payment_method.payment_method_detail.bank_transfer.bank_id. The field mirrors the bank_id sent in the original payment request and is omitted when no bank was selected.

When the payment carries a shipping selection — for example, picked inside a wallet widget with Fast Checkout shipping — the payload includes a top-level payment.shipping node (same shape as on the payment object) in both V1 and V2 versions, and payment.customer_payer.shipping_address is filled from it when the payer had none. The shipping key is omitted when the payment has no selection.

Each transaction includes connection_data, which identifies the provider connection that processed it. Use connection_data.id as the stable identifier to attribute transactions to a specific connection when you operate multiple connections for the same provider. connection_data.name is the display name configured in the Yuno dashboard and can be null on some events, such as follow-up transactions.

The transactions field carries a different meaning per surface. In webhook payloads, data.payment.transactions is a single object — the transaction that triggered the event — and transactions_history carries the full list of the payment’s transactions when it is enabled for the payment (see the note below). In the payment retrieve endpoints (GET /payments/{payment_id} and GET /payments?merchant_order_id=), transactions is an array containing every transaction of the payment.

transactions_history is opt-in: it is populated only when the payment was created with response_additional_data.transactions_history: true in the Create Payment request. Otherwise webhooks deliver it as an empty array [] — the default, which keeps payload sizes small. This matters for payments your routing retries across providers: without the flag, the final webhook shows only the last transaction, and the earlier attempts are only visible via GET /payments/{payment_id}. Payments created by Yuno-managed flows that do not set the flag (for example, subscription renewals) also deliver []. Chargeback events always include the full history.

Field naming: the customer geolocation is serialized as geo_location in webhook payloads and as geolocation in the payment retrieve endpoints. Parse each surface accordingly.

{
    "type": "payment",
    "type_event": "payment.purchase",
    "account_id": "2c05976d-1234-1234-1234-6421883de48d",
    "retry": 0,
    "version": 2,
    "data": {
        "payment": {
            "id": "a546c566-1703-4fba-b334-c46e89bc97f7",
            "account_id": "2c05976d-1234-1234-1234-6421883de48d",
            "description": "Testing Yuno",
            "country": "UY",
            "status": "SUCCEEDED",
            "sub_status": "APPROVED",
            "order_id": "Order1234",
            "merchant_order_id": "Test1234",
            "created_at": "2024-07-19T16:31:59.528561Z",
            "updated_at": "2024-07-19T16:32:02.203776Z",
            "idempotency_key": "9e2aba6a-1234-1234-1234-03a0a67ee15f",
            "amount": {
                "currency": "UYU",
                "value": 1458,
                "refunded": 0,
                "captured": 0
            },
            "checkout": {
                "session": "2f3423dd-1234-1234-1234-2c7da5ad1caf",
                "sdk_action_required": false
            },
            "customer_payer": {
                "id": "96bf8513-1234-1234-1234-0087b2a60535",
                "merchant_customer_id": "user1234",
                "first_name": "harry ",
                "last_name": "potter ",
                "gender": "",
                "date_of_birth": null,
                "email": "testing6@y.uno",
                "nationality": null,
                "ip_address": "123.123.123.27",
                "device_fingerprint": null,
                "third_party_session_id": "third_party_session_id",
                "merchant_customer_created_at": "2019-01-08T18:38:55.617Z",
                "browser_info": {
                    "user_agent": "Yuno's/20979 CFNetwork/1496.0.7 Darwin/23.5.0",
                    "accept_header": "*/*",
                    "color_depth": null,
                    "screen_height": "844.0",
                    "screen_width": "390.0",
                    "javascript_enabled": null,
                    "language": "es-UY",
                    "accept_content": null,
                    "accept_browser": null,
                    "java_enabled": null,
                    "browser_time_difference": null
                },
                "document": {
                    "document_number": "99999999",
                    "document_type": "CI"
                },
                "billing_address": {
                    "address_line_1": "GEANT - Av. A la Playa y calle de 17",
                    "address_line_2": "",
                    "city": "Canelones",
                    "country": "UY",
                    "state": "Canelones",
                    "zip_code": "-",
                    "neighborhood": null
                },
                "shipping_address": {
                    "address_line_1": "GEANT - Av. A la Playa y calle de 17",
                    "address_line_2": "",
                    "city": "Canelones",
                    "country": "UY",
                    "state": "Canelones",
                    "zip_code": "-",
                    "neighborhood": null
                },
                "phone": {
                    "country_code": "598",
                    "number": "12345678"
                }
            },
            "shipping": {
                "method": {
                    "id": "express",
                    "label": "Express shipping",
                    "amount": {
                        "currency": "GBP",
                        "value": 5.00
                    }
                },
                "address": {
                    "address_line_1": "221B Baker Street",
                    "address_line_2": "Flat 2",
                    "city": "London",
                    "state": "England",
                    "zip_code": "NW1 6XE",
                    "country": "GB"
                }
            },
            "additional_data": {
                "order": {
                    "shipping_amount": 0,
                    "fee_amount": null,
                    "tip_amount": null,
                    "items": [
                        {
                            "id": "item123",
                            "name": "Yuno Testing",
                            "quantity": 1,
                            "unit_amount": 1458,
                            "category": "services",
                            "brand": null,
                            "sku_code": null,
                            "manufacture_part_number": null,
                            "image_url": null
                        }
                    ],
                    "taxes": [],
                    "discounts": []
                },
                "airline": null,
                "seller_details": null
            },
            "transactions": {
                "id": "3a35add9-89d6-4b11-9f17-24a76f4d046e",
                "type": "PURCHASE",
                "status": "SUCCEEDED",
                "category": "CARD",
                "amount": 1458,
                "provider_id": "YUNO TEST GATEWAY",
                "response_code": "SUCCEEDED",
                "merchant_reference": "Test1234",
                "response_message": "Transaction successful",
                "reason": null,
                "description": "Testing Yuno",
                "created_at": "2024-07-19T16:31:59.617130Z",
                "updated_at": "2024-07-19T16:32:02.138835Z",
                "payment_method": {
                    "token": "902f17f9-1234-1234-1234-3322f5ebdbb5",
                    "type": "CARD",
                    "vaulted_token": "795b4f2e-1234-1234-1234-fcc1930d5d4c",
                    "vault_on_success": false,
                    "payment_method_detail": {
                        "card": {
                            "verify": null,
                            "capture": true,
                            "installments": 1,
                            "installments_plan_id": null,
                            "first_installment_deferral": null,
                            "installments_amount": null,
                            "installments_type": null,
                            "soft_descriptor": "",
                            "authorization_code": "123456",
                            "retrieval_reference_number": "",
                            "acquirer_reference_number": "",
                            "voucher": null,
                            "card_data": {
                                "holder_name": "HARRY POTTER",
                                "iin": "51584511",
                                "lfd": "1234",
                                "number_length": 16,
                                "security_code_length": 3,
                                "brand": "MASTERCARD",
                                "issuer_name": "ECONSTAR SA",
                                "issuer_code": null,
                                "category": "MRG - Prepaid MasterCard Card",
                                "type": "CREDIT",
                                "three_d_secure": {
                                    "version": null,
                                    "electronic_commerce_indicator": null,
                                    "cryptogram": null,
                                    "transaction_id": null,
                                    "directory_server_transaction_id": null,
                                    "pares_status": null,
                                    "acs_id": null
                                },
                                "network_token": null,
                                "fingerprint": null
                            },
                            "stored_credentials": {
                                "reason": null,
                                "usage": null
                            }
                        },
                        "wallet": null,
                        "bnpl": null,
                        "bank_transfer": null,
                        "ticket": null,
                        "payment_link": null
                    }
                },
                "provider": {
                    "provider_transaction_id": "YUNO-51056-b673b951-aaa-aaa-aaa-123489aee2e0"
                },
                "provider_data": {
                    "raw_response": {
                        "value": "provider raw response"
                    },
                    "id": "DLOCAL",
                    "transaction_id": "YUNO-51056-b673b951-aaa-aaa-aaa-123489aee2e0",
                    "account_id": "699ec8d444",
                    "status": "PAID",
                    "status_detail": null,
                    "response_message": "The payment was paid.",
                    "response_code": "200",
                    "third_party_transaction_id": "",
                    "third_party_account_id": ""
                },
                "connection_data": {
                    "id": "88292fd3-bf5b-4b23-bb95-7186ba4e7f88",
                    "name": "dLocal US"
                },
                "simplified_mode": false,
                "third_party_session_id": "third_party_session_id"
            },
            "transactions_history": [
                {
                    "id": "3a35add9-89d6-4b11-9f17-24a76f4d046e",
                    "type": "PURCHASE",
                    "status": "SUCCEEDED",
                    "category": "CARD",
                    "amount": 1458,
                    "provider_id": "YUNO TEST GATEWAY",
                    "response_code": "SUCCEEDED",
                    "merchant_reference": "Test1234",
                    "response_message": "Transaction successful",
                    "reason": null,
                    "description": "Testing Yuno",
                    "created_at": "2024-07-19T16:31:59.617130Z",
                    "updated_at": "2024-07-19T16:32:02.138835Z",
                    "payment_method": {
                        "token": "902f17f9-1234-1234-1234-3322f5ebdbb5",
                        "type": "CARD",
                        "vaulted_token": "795b4f2e-1234-1234-1234-fcc1930d5d4c",
                        "vault_on_success": false,
                        "payment_method_detail": {
                            "card": {
                                "verify": null,
                                "capture": true,
                                "installments": 1,
                                "installments_plan_id": null,
                                "first_installment_deferral": null,
                                "installments_amount": null,
                                "installments_type": null,
                                "soft_descriptor": "",
                                "authorization_code": "123456",
                                "retrieval_reference_number": "",
                                "acquirer_reference_number": "",
                                "voucher": null,
                                "card_data": {
                                    "holder_name": "HARRY POTTER",
                                    "iin": "51584511",
                                    "lfd": "1234",
                                    "number_length": 16,
                                    "security_code_length": 3,
                                    "brand": "MASTERCARD",
                                    "issuer_name": "ECONSTAR SA",
                                    "issuer_code": null,
                                    "category": "MRG - Prepaid MasterCard Card",
                                    "type": "CREDIT",
                                    "three_d_secure": {
                                        "version": null,
                                        "electronic_commerce_indicator": null,
                                        "cryptogram": null,
                                        "transaction_id": null,
                                        "directory_server_transaction_id": null,
                                        "pares_status": null,
                                        "acs_id": null
                                    },
                                    "network_token": null,
                                    "fingerprint": null
                                },
                                "stored_credentials": {
                                    "reason": null,
                                    "usage": null
                                }
                            },
                            "wallet": null,
                            "bnpl": null,
                            "bank_transfer": null,
                            "ticket": null,
                            "payment_link": null
                        }
                    },
                    "provider": {
                        "provider_transaction_id": "YUNO-51056-b673b951-aaa-aaa-aaa-123489aee2e0"
                    },
                    "provider_data": {
                        "raw_response": {
                            "value": "raw_response"
                        },
                        "id": "DLOCAL",
                        "transaction_id": "YUNO-51056-b673b951-aaa-aaa-aaa-123489aee2e0",
                        "account_id": "699ec8d444",
                        "status": "PAID",
                        "status_detail": null,
                        "response_message": "The payment was paid.",
                        "response_code": "200",
                        "third_party_transaction_id": "",
                        "third_party_account_id": ""
                    },
                    "connection_data": {
                        "id": "88292fd3-bf5b-4b23-bb95-7186ba4e7f88",
                        "name": "dLocal US"
                    },
                    "simplified_mode": false,
                    "third_party_session_id": "json object"
                }
            ],
            "callback_url": null,
            "workflow": "SDK_CHECKOUT",
            "split": [],
            "payment_link_code": "",
            "subscription_id": null,
            "fraud_screening": null,
            "metadata": [],
            "routing_rules": {
                "condition": {
                    "id": 222770,
                    "name": null,
                    "description": null
                }
            }
        }
    }
}

Payments created with an external_subscription object (see Create payment) carry it in the webhook payload as a top-level external_subscription key with id and customer_id. The key is omitted (not sent as null) when the payment was created without it, which is why the example above does not show it. Both webhook versions carry the field.

When the payment carries a Yuno promotion, the payload also has payment.discount_amount (currency and value, the total discount), placed right after amount. The Yuno discount line comes first in payment.additional_data.order.discounts (type: YUNO_PROMOTION, quote_id, id, unit_amount, and name when Yuno has it), and your own discount lines follow it with type: MERCHANT. payment.amount.value stays the amount you sent, and payment.transactions.amount is the amount charged. Without a promotion, discount_amount is omitted and the discount lines are exactly as you sent them. Both webhook versions carry the field. The excerpt below shows only the fields that change.

Payment with a Yuno promotion (excerpt)

{
    "type": "payment",
    "type_event": "payment.purchase",
    "version": 2,
    "data": {
        "payment": {
            "status": "SUCCEEDED",
            "sub_status": "APPROVED",
            "amount": {
                "currency": "USD",
                "value": 250.0,
                "refunded": 0.0,
                "captured": 0.0
            },
            "discount_amount": {
                "currency": "USD",
                "value": 25.0
            },
            "additional_data": {
                "order": {
                    "discounts": [
                        {
                            "type": "YUNO_PROMOTION",
                            "id": "b7c1a4f2-6e0d-4a3b-9c55-1f2e7d8a0b31",
                            "name": "10% off with credit cards - Mother's Day",
                            "unit_amount": 25.0,
                            "quote_id": "qte_…",
                            "discount_indicator": null,
                            "discount_rate": null
                        },
                        {
                            "type": "MERCHANT",
                            "id": "LOYALTY-5",
                            "name": "Loyalty 5%",
                            "unit_amount": 12.5,
                            "discount_indicator": null,
                            "discount_rate": null
                        }
                    ]
                }
            },
            "transactions": {
                "type": "PURCHASE",
                "status": "SUCCEEDED",
                "amount": 225.0
            }
        }
    }
}

Payment Webhook V1

Example payload:

JSON

{
   "payment":{
      "code":"b3da6717-7949-454e-8699-e449bfaccb69",
      "id":"b3da6717-7949-454e-8699-e449bfaccb69",
      "idempotency_key":"28f14927-421b-4424-b4d2-5de4d83ca138",
      "organization_code":"9c99108c-7681-4d48-acca-bce037685e99",
      "account_code":"c004cfd7-0c65-4add-b9b3-3d7e3949c9f1",
      "account_id":"c004cfd7-0c65-4add-b9b3-3d7e3949c9f1",
      "description":"test description",
      "country":"CO",
      "status":"SUCCEEDED",
      "sub_status":"APPROVED",
      "order_id":"1679531154456",
      "merchant_order_id":"1679531154456",
      "created_at":"2023-03-23T00:26:38.093810Z",
      "updated_at":"2023-03-23T00:26:51.285333Z",
      "amount":{
         "currency":"COP",
         "value":2000.0,
         "refunded":0.0,
         "captured":0.0
      },
      "checkout":{
         "session":"fb98b19d-39c0-42d2-bed6-438605458964",
         "sdk_action_required":false
      },
      "customer_payer":{
         "code":"8122d1f5-c07d-4d88-9dfe-a09ccdaeda0b",
         "id":"8122d1f5-c07d-4d88-9dfe-a09ccdaeda0b",
         "organization_customer_external_id":"1679531154456",
         "merchant_customer_id":"1679531154456",
         "first_name":"Aaron",
         "last_name":"Hegmann",
         "gender":"F",
         "date_of_birth":"1990-02-28",
         "email":"andrea@y.uno",
         "nationality":"CO",
         "ip_address":"192.168.123.167",
         "device_fingerprint":"278994bb-9ece-5c63-8c44-c03481851625",
         "browser_info":null,
         "document":{
            "document_number":"1032765432",
            "document_type":"CC"
         },
         "billing_address":{
            "address_line_1":"Calle 34 # 56 - 78",
            "address_line_2":"Apartamento 502, Torre I",
            "city":"Bogotá",
            "country":"CO",
            "state":"Cundinamarca",
            "zip_code":"111111"
         },
         "shipping_address":{
            "address_line_1":"Calle 34 # 56 - 78",
            "address_line_2":"Apartamento 502, Torre I",
            "city":"Bogotá",
            "country":"CO",
            "state":"Cundinamarca",
            "zip_code":"111111"
         },
         "phone":{
            "country_code":"57",
            "number":"3991111111"
         }
      },
      "shipping":{
         "method":{
            "id":"express",
            "label":"Express shipping",
            "amount":{
               "currency":"GBP",
               "value":5.00
            }
         },
         "address":{
            "address_line_1":"221B Baker Street",
            "address_line_2":"Flat 2",
            "city":"London",
            "state":"England",
            "zip_code":"NW1 6XE",
            "country":"GB"
         }
      },
      "additional_data":{
         "order":{
            "shipping_amount":0.0,
            "fee_amount":0.0,
            "items":[
               {
                  "id":"123AD",
                  "name":"Skirt",
                  "quantity":1,
                  "unit_amount":2000.0,
                  "category":"Clothes",
                  "brand":"XYZ",
                  "sku_code":"8765432109",
                  "manufacture_part_number":"XYZ123456",
                  "image_url":null
               }
            ],
            "discounts":[]
         },
         "airline":null
      },
      "transactions":{
         "code":"98c80022-fe05-4b9b-b478-2e102fc72cc3",
         "id":"98c80022-fe05-4b9b-b478-2e102fc72cc3",
         "type":"PURCHASE",
         "status":"SUCCEEDED",
         "category":"CARD",
         "amount":2000.0,
         "provider_id":"KUSHKI",
         "response_code":"SUCCEEDED",
         "merchant_reference":null,
         "response_message":"Transaction successful",
         "reason":null,
         "description":"test description",
         "created_at":"2023-03-23T00:26:38.290239Z",
         "updated_at":"2023-03-23T00:26:51.258039Z",
         "payment_method":{
            "token":"e12440ca-920c-4aab-b656-6ed63f9ed5ac",
            "type":"CARD",
            "vaulted_token":null,
            "vault_on_success":false,
            "payment_method_detail":{
               "card":{
                  "verify":null,
                  "capture":false,
                  "installments":1,
                  "first_installment_deferral":null,
                  "installments_amount":null,
                  "installments_type":null,
                  "soft_descriptor":"",
                  "authorization_code":"",
                  "retrieval_reference_number":"",
                  "acquirer_reference_number":"",
                  "voucher":null,
                  "card_data":{
                     "holder_name":"APROBADO",
                     "iin":"54519515",
                     "lfd":"5480",
                     "number_length":16,
                     "security_code_length":3,
                     "brand":"MASTERCARD",
                     "issuer_name":"BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
                     "issuer_code":null,
                     "category":"BLACK",
                     "type":"CREDIT"
                  }
               },
               "wallet":null,
               "bnpl":null,
               "bank_transfer":null,
               "payment_link":null
            }
         },
         "provider":{
            "provider_transaction_id":"488990863216107201"
         },
         "provider_data":{
            "raw_response":{
               "details":{
                  "amount":{
                     "currency":"COP",
                     "ice":0,
                     "iva":0,
                     "subtotalIva":0,
                     "subtotalIva0":2000
                  },
                  "approvalCode":"000000",
                  "approvedTransactionAmount":2000,
                  "binInfo":{
                     "bank":"Banco de la Produccion S.A. (PRODUBANCO)",
                     "bindCard":"545195",
                     "cardCountry":"Ecuador",
                     "lastFourDigits":"5480",
                     "type":"credit"
                  },
                  "cardHolderName":"APROBADO",
                  "created":1679531210000,
                  "merchantId":"20000000107058310000",
                  "merchantName":"kushkiCOSBX Colombia",
                  "paymentBrand":"Mastercard",
                  "processorBankName":"0032~BANCO INTERNACIONAL",
                  "requestAmount":2000,
                  "responseCode":"000",
                  "responseText":"Transacción aprobada",
                  "transactionId":"091607275430589119",
                  "transactionReference":"eb6eb9e1-68d3-46be-8a0b-41ec8ff3ad73",
                  "transactionStatus":"APPROVAL",
                  "transactionType":"SALE"
               },
               "ticketNumber":"488990863216107201",
               "transactionReference":"eb6eb9e1-68d3-46be-8a0b-41ec8ff3ad73"
            },
            "id":"KUSHKI",
            "transaction_id":"488990863216107201",
            "account_id":null,
            "status":"APPROVAL",
            "status_detail":"Transacción aprobada",
            "response_message":"Transacción aprobada"
         },
         "connection_data":{
            "id":"88292fd3-bf5b-4b23-bb95-7186ba4e7f88",
            "name":"Kushki Colombia"
         }
      },
      "callback_url":null,
      "workflow":"CHECKOUT",
      "split":[ 
      ],
     "subscription_id":null,
     "payment_link_id":null
   }
}

Chargeback Webhook V2

Example payload:

{
   "type":"payment",
   "type_event":"payment.chargeback",
   "account_id":"a4441009-df56-4a59-a515-ca9b949c4ce3",
   "retry":0,
   "version":2,
   "data":{
      "payment":{
         "id":"ae70d7f9-e0a2-4e37-a12f-765e8af87924",
         "account_id":"a4441009-df56-4a59-a515-ca9b949c4ce3",
         "description":"test Ecommerce",
         "country":"MX",
         "status":"IN_DISPUTE",
         "sub_status":"RECEIVED",
         "order_id":"584-67f854a2eb05a22320e86071",
         "merchant_order_id":"584-67f854a2eb05a22320e86071",
         "created_at":"2025-04-10T23:30:53.210656Z",
         "updated_at":"2025-04-17T04:46:49.640765Z",
         "idempotency_key":"485d3965-6deb-4fc5-81de-4a7211c835bc",
         "amount":{
            "currency":"MXN",
            "value":418.0,
            "refunded":0.0,
            "captured":0.0,
            "currency_conversion": {
               "code": "ccv_01HVK3Z9M2...",
               "cardholder_currency": "QAR",
               "cardholder_amount": 3640.00,
               "cardholder_accepted": true,
               "rate": 3.6400,
               "rate_margin_percentage": 3.75,
               "rate_source": "ECB",
               "provider": "FEXCO",
               "description": "You have chosen to pay in QAR. Amount: 3640.00 QAR. Rate: 3.6400.",
               "created_at": "2026-04-24T14:30:00Z",
               "expires_at": "2026-04-24T15:30:00Z",
               "status": "APPLIED",
               "error_reason": null,
               "provider_data": {
                 "acquirer_id": "MPGS_01"
               }
            }
         },
         "checkout":{
            "session":"4f335b32-79de-41a7-b30b-f478620bc7a8",
            "sdk_action_required":false
         },
         "customer_payer":{
            "id":"4476c479-9a32-4910-83d8-b74b7b8eb86f",
            "merchant_customer_id":"67f854536e2a02461a1a8f5f",
            "first_name":"merit",
            "last_name":"amador",
            "gender":"",
            "date_of_birth":null,
            "email":"bolitas.nuca9b@icloud.com",
            "nationality":null,
            "ip_address":"200.68.159.190",
            "device_fingerprint":null,
            "third_party_session_id":null,
            "device_fingerprints":[
               
            ],
            "merchant_customer_created_at":"2025-04-10T23:23:46.357Z",
            "browser_info":{
               "user_agent":"Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/604.1",
               "accept_header":"*/*",
               "color_depth":"24",
               "screen_height":"852",
               "screen_width":"393",
               "javascript_enabled":true,
               "language":"es",
               "accept_content":"*/*",
               "accept_browser":"*/*",
               "java_enabled":false,
               "browser_time_difference":"360"
            },
            "document":null,
            "billing_address":{
               "address_line_1":"Av. test test No. 193 Local C-1-2-3 Plaza Galerias Col. test test C.P11300 test D.F",
               "address_line_2":"",
               "city":"test",
               "country":"MX",
               "state":"-",
               "zip_code":"-",
               "neighborhood":null
            },
            "shipping_address":{
               "address_line_1":"Av. test test No. 193 Local C-1-2-3 test test Col. test test C.P11300 test D.F",
               "address_line_2":"",
               "city":"CDMX",
               "country":"MX",
               "state":"-",
               "zip_code":"-",
               "neighborhood":null
            },
            "phone":{
               "country_code":"52",
               "number":"5659708369"
            }
         },
         "additional_data":{
            "order":{
               "shipping_amount":0.0,
               "fee_amount":0.0,
               "tip_amount":null,
               "items":[
                  {
                     "id":"26609",
                     "name":"McTrío Grande Signature BBQ Crispy Onion",
                     "quantity":2,
                     "unit_amount":193.0,
                     "category":"others",
                     "brand":null,
                     "sku_code":"26609",
                     "manufacture_part_number":null,
                     "image_url":null
                  }
               ],
               "taxes":[
                  
               ],
               "shipping":null,
               "account_funding":null,
               "tickets":[
                  
               ],
               "fulfillment":null,
               "discounts":[
                  
               ]
            },
            "airline":null,
            "seller_details":null
         },
         "transactions":{
            "id":"5f354190-ffe8-4b25-a73d-55fe25821067",
            "type":"CHARGEBACK",
            "status":"CREATED",
            "category":"CARD",
            "amount":418.0,
            "provider_id":"ADYEN",
            "response_code":"ACTION_REQUIRED",
            "merchant_reference":"YU00000058467f854a2eb05a22320e86071",
            "response_message":"Chargeback or Inquiry received. Decision or documentation must be provided",
            "reason":"REQUESTED_BY_CUSTOMER",
            "description":"webhook transaction",
            "created_at":"2025-04-17T04:46:49.591869Z",
            "updated_at":"2025-04-17T04:46:49.616143Z",
            "payment_method":{
               "token":"592c7a1c-e34c-4dc1-851f-5bd41bc32c68",
               "type":"CARD",
               "vaulted_token":"2146a9c4-56c9-43a5-a35b-916bf15f7772",
               "vault_on_success":false,
               "parent_payment_method_type":null,
               "payment_method_detail":{
                  "card":{
                     "verify":false,
                     "capture":false,
                     "installments":1,
                     "installments_plan_id":null,
                     "first_installment_deferral":null,
                     "installments_amount":null,
                     "installments_type":null,
                     "soft_descriptor":"",
                     "authorization_code":"373761",
                     "retrieval_reference_number":"",
                     "acquirer_reference_number":"",
                     "voucher":null,
                     "card_data":{
                        "holder_name":"YOANA CALAM",
                        "iin":"55123824",
                        "lfd":"2451",
                        "number_length":16,
                        "security_code_length":3,
                        "brand":"MASTERCARD",
                        "issuer_name":"BANCO AZTECA INSTITUCION BANCA MULTIPLE",
                        "issuer_code":null,
                        "country_code":"MX",
                        "category":"DEBIT MASTERCARD",
                        "type":"DEBIT",
                        "three_d_secure":{
                           "version":null,
                           "electronic_commerce_indicator":null,
                           "cryptogram":null,
                           "transaction_id":null,
                           "directory_server_transaction_id":null,
                           "pares_status":null,
                           "acs_id":null
                        },
                        "network_token":null,
                        "fingerprint":"355e7384-7e75-4a32-94b9-26031a4faab5",
                        "expiration_month":12,
                        "expiration_year":26
                     },
                     "stored_credentials":{
                        "reason":null,
                        "usage":null,
                        "subscription_agreement_id":null,
                        "network_transaction_id":null
                     }
                  },
                  "wallet":null,
                  "bnpl":null,
                  "bank_transfer":null,
                  "ticket":null,
                  "payment_link":null
               }
            },
            "provider":{
               "provider_transaction_id":"L2JC9B5K995BJDF6"
            },
            "provider_data":{
               "raw_response":null,
               "id":"ADYEN",
               "transaction_id":"L2JC9B5K995BJDF6",
               "account_id":null,
               "status":"NOTIFICATION_OF_CHARGEBACK",
               "status_detail":null,
               "response_message":null,
               "response_code":null,
               "third_party_transaction_id":null,
               "third_party_account_id":null,
               "iso8583_response_code":null,
               "iso8583_response_message":null
            },
            "connection_data":{
               "id":null,
               "name":null
            },
            "device_fingerprint":null,
            "simplified_mode":false,
            "third_party_session_id":null
         },
         "transactions_history":[
            {
               "id":"5f354190-ffe8-4b25-a73d-55fe25821067",
               "type":"CHARGEBACK",
               "status":"CREATED",
               "category":"CARD",
               "amount":418.0,
               "provider_id":"ADYEN",
               "response_code":"ACTION_REQUIRED",
               "merchant_reference":"YU00000058467f854a2eb05a22320e86071",
               "response_message":"Chargeback or Inquiry received. Decision or documentation must be provided",
               "reason":"REQUESTED_BY_CUSTOMER",
               "description":"webhook transaction",
               "created_at":"2025-04-17T04:46:49.591869Z",
               "updated_at":"2025-04-17T04:46:49.616143Z",
               "payment_method":{
                  "token":"592c7a1c-e34c-4dc1-851f-5bd41bc32c68",
                  "type":"CARD",
                  "vaulted_token":"2146a9c4-56c9-43a5-a35b-916bf15f7772",
                  "vault_on_success":false,
                  "parent_payment_method_type":null,
                  "payment_method_detail":{
                     "card":{
                        "verify":false,
                        "capture":false,
                        "installments":1,
                        "installments_plan_id":null,
                        "first_installment_deferral":null,
                        "installments_amount":null,
                        "installments_type":null,
                        "soft_descriptor":"",
                        "authorization_code":"373761",
                        "retrieval_reference_number":"",
                        "acquirer_reference_number":"",
                        "voucher":null,
                        "card_data":{
                           "holder_name":"YOANA CALAM",
                           "iin":"55123824",
                           "lfd":"2451",
                           "number_length":16,
                           "security_code_length":3,
                           "brand":"MASTERCARD",
                           "issuer_name":"BANCO AZTECA INSTITUCION BANCA MULTIPLE",
                           "issuer_code":null,
                           "country_code":"MX",
                           "category":"DEBIT MASTERCARD",
                           "type":"DEBIT",
                           "three_d_secure":{
                              "version":null,
                              "electronic_commerce_indicator":null,
                              "cryptogram":null,
                              "transaction_id":null,
                              "directory_server_transaction_id":null,
                              "pares_status":null,
                              "acs_id":null
                           },
                           "network_token":null,
                           "fingerprint":"355e7384-7e75-4a32-94b9-26031a4faab5",
                           "expiration_month":12,
                           "expiration_year":26
                        },
                        "stored_credentials":{
                           "reason":null,
                           "usage":null,
                           "subscription_agreement_id":null,
                           "network_transaction_id":null
                        }
                     },
                     "wallet":null,
                     "bnpl":null,
                     "bank_transfer":null,
                     "ticket":null,
                     "payment_link":null
                  }
               },
               "provider":{
                  "provider_transaction_id":"L2JC9B5K995BJDF6"
               },
               "provider_data":{
                  "raw_response":null,
                  "id":"ADYEN",
                  "transaction_id":"L2JC9B5K995BJDF6",
                  "account_id":null,
                  "status":"NOTIFICATION_OF_CHARGEBACK",
                  "status_detail":null,
                  "response_message":null,
                  "response_code":null,
                  "third_party_transaction_id":null,
                  "third_party_account_id":null,
                  "iso8583_response_code":null,
                  "iso8583_response_message":null
               },
               "connection_data":{
                  "id":null,
                  "name":null
               },
               "device_fingerprint":null,
               "simplified_mode":false,
               "third_party_session_id":null
            },
            {
               "id":"4d508842-5ffc-438a-a864-deeceb9935ca",
               "type":"PURCHASE",
               "status":"SUCCEEDED",
               "category":"CARD",
               "amount":418.0,
               "provider_id":"ADYEN",
               "response_code":"SUCCEEDED",
               "merchant_reference":"YU00000058467f854a2eb05a22320e86071",
               "response_message":"Transaction successful",
               "reason":null,
               "description":"McDonalds Ecommerce",
               "created_at":"2025-04-10T23:30:53.319251Z",
               "updated_at":"2025-04-10T23:30:54.496131Z",
               "payment_method":{
                  "token":"592c7a1c-e34c-4dc1-851f-5bd41bc32c68",
                  "type":"CARD",
                  "vaulted_token":"2146a9c4-56c9-43a5-a35b-916bf15f7772",
                  "vault_on_success":false,
                  "parent_payment_method_type":null,
                  "payment_method_detail":{
                     "card":{
                        "verify":false,
                        "capture":true,
                        "installments":1,
                        "installments_plan_id":null,
                        "first_installment_deferral":null,
                        "installments_amount":null,
                        "installments_type":null,
                        "soft_descriptor":"",
                        "authorization_code":"373761",
                        "retrieval_reference_number":"",
                        "acquirer_reference_number":"",
                        "voucher":null,
                        "card_data":{
                           "holder_name":"YOANA CALAM",
                           "iin":"55123824",
                           "lfd":"2451",
                           "number_length":16,
                           "security_code_length":3,
                           "brand":"MASTERCARD",
                           "issuer_name":"BANCO AZTECA INSTITUCION BANCA MULTIPLE",
                           "issuer_code":null,
                           "country_code":"MX",
                           "category":"DEBIT MASTERCARD",
                           "type":"DEBIT",
                           "three_d_secure":{
                              "version":null,
                              "electronic_commerce_indicator":null,
                              "cryptogram":null,
                              "transaction_id":null,
                              "directory_server_transaction_id":null,
                              "pares_status":null,
                              "acs_id":null
                           },
                           "network_token":null,
                           "fingerprint":"355e7384-7e75-4a32-94b9-26031a4faab5",
                           "expiration_month":12,
                           "expiration_year":26
                        },
                        "stored_credentials":{
                           "reason":null,
                           "usage":null,
                           "subscription_agreement_id":null,
                           "network_transaction_id":null
                        }
                     },
                     "wallet":null,
                     "bnpl":null,
                     "bank_transfer":null,
                     "ticket":null,
                     "payment_link":null
                  }
               },
               "provider":{
                  "provider_transaction_id":"L2JC9B5K995BJDF6"
               },
               "provider_data":{
                  "raw_response":{
                     "additionalData":{
                        "acquirerAccountCode":"AdyenProsa_ArcosDouradosPlataforma-MX_Cvv",
                        "acquirerCode":"AdyenProsa",
                        "acquirerReference":"373761",
                        "authCode":"373761",
                        "authorisationMid":"9024452",
                        "avsResult":"0 Unknown",
                        "cardFunction":"Consumer",
                        "cavv":"N/A",
                        "cavvAlgorithm":"N/A",
                        "cvcResult":"1 Matches",
                        "cvcResultRaw":"1 Matches",
                        "eci":"N/A",
                        "liabilityShift":"false",
                        "paymentMethod":"mc",
                        "paymentMethodVariant":"mcstandarddebit",
                        "refusalReasonRaw":"00 : Approved or completed successfully",
                        "threeDAuthenticated":"false",
                        "threeDAuthenticatedResponse":"N/A",
                        "threeDOffered":"false",
                        "threeDOfferedResponse":"N/A",
                        "threeds2.cardEnrolled":"true",
                        "xid":"N/A"
                     },
                     "amount":{
                        "currency":"MXN",
                        "value":41800
                     },
                     "merchantReference":"584-67f854a2eb05a22320e86071",
                     "paymentMethod":{
                        "brand":"mc",
                        "type":"scheme"
                     },
                     "pspReference":"L2JC9B5K995BJDF6",
                     "resultCode":"Authorised"
                  },
                  "id":"ADYEN",
                  "transaction_id":"L2JC9B5K995BJDF6",
                  "account_id":"test-account",
                  "status":"Authorised",
                  "status_detail":"Authorised",
                  "response_message":null,
                  "response_code":null,
                  "third_party_transaction_id":"L2JC9B5K995BJDF6",
                  "third_party_account_id":"",
                  "iso8583_response_code":"00 ",
                  "iso8583_response_message":null
               },
               "connection_data":{
                  "id":"72f2adb3-ed95-4bca-be01-20bbe4d5a1cb",
                  "name":null
               },
               "device_fingerprint":null,
               "simplified_mode":false,
               "third_party_session_id":null
            }
         ],
         "callback_url":"https://test.com.mx/api/callback/my-orders?path=%2Fmi-cuenta%2Fmis-pedidos%2F67f854a2eb05a22320e86071&checkoutSession=5f446b32-79de-41a7-b30b-f478620bc7a8",
         "workflow":"SDK_CHECKOUT",
         "split_marketplace":[
            
         ],
         "payment_link_code":"",
         "subscription_id":null,
         "fraud_screening":null,
         "metadata":[
            {
               "key":"riskdata.deliveryMethod",
               "value":"MOP"
            },
            {
               "key":"riskdata.storeId",
               "value":"584"
            },
            {
               "key":"riskdata.basket.item1.amountPerItem",
               "value":"41800"
            },
            {
               "key":"riskdata.basket.item1.itemID",
               "value":"26609"
            },
            {
               "key":"riskdata.basket.item1.category",
               "value":"test value"
            },
            {
               "key":"riskdata.basket.item1.currency",
               "value":"MXN"
            },
            {
               "key":"riskdata.basket.item1.quantity",
               "value":"2"
            },
            {
               "key":"riskdata.basket.item1.productTitle",
               "value":"test value"
            }
         ],
         "routing_rules":{
            "smart_routing":false,
            "monitors":false,
            "condition":{
               "id":537769,
               "name":null,
               "description":null
            }
         }
      }
   }
}

Chargeback Webhook V1

Example payload:

JSON

{
   "payment":{
      "code":"b3da6717-7949-454e-8699-e449bfaccb69",
      "id":"b3da6717-7949-454e-8699-e449bfaccb69",
      "idempotency_key":"28f14927-421b-4424-b4d2-5de4d83ca138",
      "organization_code":"9c99108c-7681-4d48-acca-bce037685e99",
      "account_code":"c004cfd7-0c65-4add-b9b3-3d7e3949c9f1",
      "account_id":"c004cfd7-0c65-4add-b9b3-3d7e3949c9f1",
      "description":"test description",
      "country":"CO",
      "status":"CHARGEBACK",
      "sub_status":"LOST",
      "order_id":"1679531154456",
      "merchant_order_id":"1679531154456",
      "created_at":"2023-03-23T00:26:38.093810Z",
      "updated_at":"2023-03-23T00:26:51.285333Z",
      "amount":{
         "currency":"COP",
         "value":2000.0,
         "refunded":0.0,
         "captured":0.0
      },
      "checkout":{
         "session":"fb98b19d-39c0-42d2-bed6-438605458964",
         "sdk_action_required":false
      },
      "customer_payer":{
         "code":"8122d1f5-c07d-4d88-9dfe-a09ccdaeda0b",
         "id":"8122d1f5-c07d-4d88-9dfe-a09ccdaeda0b",
         "organization_customer_external_id":"1679531154456",
         "merchant_customer_id":"1679531154456",
         "first_name":"Aaron",
         "last_name":"Hegmann",
         "gender":"F",
         "date_of_birth":"1990-02-28",
         "email":"andrea@y.uno",
         "nationality":"CO",
         "ip_address":"192.168.123.167",
         "device_fingerprint":"278994bb-9ece-5c63-8c44-c03481851625",
         "browser_info":null,
         "document":{
            "document_number":"1032765432",
            "document_type":"CC"
         },
         "billing_address":{
            "address_line_1":"Calle 34 # 56 - 78",
            "address_line_2":"Apartamento 502, Torre I",
            "city":"Bogotá",
            "country":"CO",
            "state":"Cundinamarca",
            "zip_code":"111111"
         },
         "shipping_address":{
            "address_line_1":"Calle 34 # 56 - 78",
            "address_line_2":"Apartamento 502, Torre I",
            "city":"Bogotá",
            "country":"CO",
            "state":"Cundinamarca",
            "zip_code":"111111"
         },
         "phone":{
            "country_code":"57",
            "number":"3991111111"
         }
      },
      "additional_data":{
         "order":{
            "shipping_amount":0.0,
            "fee_amount":0.0,
            "items":[
               {
                  "id":"123AD",
                  "name":"Skirt",
                  "quantity":1,
                  "unit_amount":2000.0,
                  "category":"Clothes",
                  "brand":"XYZ",
                  "sku_code":"8765432109",
                  "manufacture_part_number":"XYZ123456",
                  "image_url":null
               }
            ]
         },
         "airline":null
      },
      "transactions":{
         "code":"98c80022-fe05-4b9b-b478-2e102fc72cc3",
         "id":"98c80022-fe05-4b9b-b478-2e102fc72cc3",
         "type":"CHARGEBACK",
         "status":"LOST",
         "category":"CARD",
         "amount":2000.0,
         "provider_id":"KUSHKI",
         "response_code":"CHARGEBACK",
         "merchant_reference":null,
         "response_message":"Transaction successful",
         "reason":null,
         "description":"test description",
         "created_at":"2023-03-23T00:26:38.290239Z",
         "updated_at":"2023-03-23T00:26:51.258039Z",
         "payment_method":{
            "token":"e12440ca-920c-4aab-b656-6ed63f9ed5ac",
            "type":"CARD",
            "vaulted_token":null,
            "vault_on_success":false,
            "payment_method_detail":{
               "card":{
                  "verify":null,
                  "capture":false,
                  "installments":1,
                  "first_installment_deferral":null,
                  "installments_amount":null,
                  "installments_type":null,
                  "soft_descriptor":"",
                  "authorization_code":"",
                  "retrieval_reference_number":"",
                  "acquirer_reference_number":"",
                  "voucher":null,
                  "card_data":{
                     "holder_name":"APROBADO",
                     "iin":"54519515",
                     "lfd":"5480",
                     "number_length":16,
                     "security_code_length":3,
                     "brand":"MASTERCARD",
                     "issuer_name":"BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
                     "issuer_code":null,
                     "category":"BLACK",
                     "type":"CREDIT"
                  }
               },
               "wallet":null,
               "bnpl":null,
               "bank_transfer":null,
               "payment_link":null
            }
         },
         "provider":{
            "provider_transaction_id":"488990863216107201"
         },
         "provider_data":{
            "raw_response":{
               },
            "id":"KUSHKI",
            "transaction_id":"488990863216107201",
            "account_id":null,
            "status":"CHARGEBACK",
            "status_detail":"",
            "response_message":""
         }
      },
      "callback_url":null,
      "workflow":"SDK_CHECKOUT",
      "split":[
         
      ]
   }
}

payment.pre_chargeback

Sent when a pre-chargeback notice or fraud alert is received for a payment, ahead of a full chargeback. Currently sent to any webhook with at least one payment_triggers value, regardless of whether PRECHARGEBACK is selected; a dedicated trigger gate is planned for a future release.

{
  "type": "payment",
  "type_event": "payment.pre_chargeback",
  "account_id": "2c05976d-1234-1234-1234-6421883de48d",
  "retry": 0,
  "version": 2,
  "data": {
    "payment": {
      "id": "8f3a1b6c-4d2e-4f8a-9b1c-7e5d3a2f6b04",
      "account_id": "2c05976d-1234-1234-1234-6421883de48d",
      "description": "Order 12578185913914",
      "country": "BR",
      "status": "SUCCEEDED",
      "sub_status": "APPROVED",
      "order_id": "ORDER-12578185913914",
      "merchant_order_id": "ORDER-12578185913914",
      "created_at": "2026-07-11T05:04:49.855791Z",
      "updated_at": "2026-08-17T16:32:03.145543Z",
      "idempotency_key": "4a6f2d18-9b73-4c51-a2e9-6d3b8f1c07a4",
      "amount": {
        "currency": "BRL",
        "value": 24.9,
        "refunded": 0.0,
        "captured": 0.0,
        "currency_conversion": null
      },
      "workflow": "DIRECT",
      "fraud_screening": null,
      "transactions": {
        "id": "3d5e8c92-1f47-4a63-b8d0-5c2a9e7f14b6",
        "type": "PRE_CHARGEBACK",
        "status": "CREATED",
        "category": "CARD",
        "amount": 24.9,
        "provider_id": "ADYEN",
        "response_code": "ACTION_REQUIRED",
        "merchant_reference": "ORDER-12578185913914",
        "response_message": "Chargeback or Inquiry received. Decision or documentation must be provided",
        "reason": "FRAUDULENT",
        "description": "webhook transaction",
        "created_at": "2026-08-17T16:32:03.075632Z",
        "updated_at": "2026-08-17T16:32:03.103778Z",
        "provider": { "provider_transaction_id": "PROVIDER_CASE_ID" },
        "provider_data": {
          "id": "ADYEN",
          "transaction_id": "PROVIDER_CASE_ID",
          "account_id": "merchant_account_name",
          "status": "NOTIFICATION_OF_FRAUD",
          "raw_response": null,
          "status_detail": null,
          "response_message": null,
          "response_code": null,
          "reason_code": null,
          "reason_description": null
        },
        "connection_data": { "id": "6c4b2f79-8e13-4d5a-9f27-0a3e6b8d51c9", "name": "connection_name" }
      }
    }
  }
}

Enrollment

The next JSON object presents an example of a data structure related to an enrollment event.

{
  "type": "enrollment",
  "type_event": "enrollment.enroll",
  "account_id": "493e9374-510a-4201-9e09-de669d75f256",
  "retry": 0,
  "version": 2,
  "data": {
    "payment_method": {
      "id": "03c3aae1-ed42-4be6-bc24-de5487f58491",
      "account_id": "493e9374-510a-4201-9e09-de669d75f256",
      "name": "VISA ****1111",
      "description": "VISA ****1111",
      "type": "CARD",
      "category": "CARD",
      "country": "CO",
      "status": "ENROLLED",
      "customer_id": "2f38972e-2427-43b7-95be-ee4cf21cef1b",
      "created_at": "2024-09-10T15:04:10.453741Z",
      "updated_at": "2024-09-10T15:04:10.453745Z",
      "enrollment": {
        "session": null,
        "sdk_action_required": false
      },
      "verify": {
        "vault_on_success": false,
        "currency": null,
        "payment": null
      },
      "detail": {
        "card": {
          "holder_name": "Pepito Perez",
          "expiration_month": 3,
          "expiration_year": 26,
          "iin": "41111111",
          "lfd": "1111",
          "security_code_length": 3,
          "number_length": 16,
          "brand": "VISA",
          "issuer_name": "JPMORGAN CHASE BANK N A",
          "issuer_code": null,
          "type": "CREDIT",
          "category": "CREDIT",
          "country_code": "US",
          "country_name": "United States of America",
          "fingerprint_code": "d244e20d-43a1-43f7-9b48-0a76423be35e",
          "created_at": "2024-09-10T15:04:10.453799Z",
          "updated_at": "2024-09-10T15:04:10.453800Z"
        }
      }
    }
  }
}

When an enrollment is created with verify.external_subscription (see Enroll payment method), the object is echoed in the enrollment response and persisted on the verification payment — it is not part of the enrollment webhook payload. To correlate later, use the verification payment: its id comes back in the enrollment response (verify.payment.id) and the object is returned by Retrieve payment and in payment webhooks.

Payouts

The next JSON object presents an example of a data structure related to a payout event.

JSON

{
  "type": "payout",
  "type_event": "payout.payout",
  "account_id": "f7c5fe77-721b-49c2-84d3-957748df3c2c",
  "retry": 0,
  "version": 2,
  "data": {
    "id": "0cbc7bd4-04f3-4897-b3c6-4d5f36a6b9a7",
    "status": "SUCCEEDED",
    "merchant_reference": "MR-12345",
    "description": null,
    "country": "BR",
    "account_code": "f7c5fe77-721b-49c2-84d3-957748df3c2c",
    "organization_code": "6c6a6b2c-c9c0-4104-9dd0-4237e6f00047",
    "purpose": null,
    "amount": {
      "currency": "BRL",
      "value": 100
    },
    "beneficiary": {
      "merchant_beneficiary_id": "test_merchant_deposit_id",
      "national_entity": null,
      "first_name": null,
      "last_name": null,
      "legal_name": null,
      "email": null,
      "country": "BR",
      "date_of_birth": null,
      "document": null,
      "phone": null,
      "address": null
    },
    "transactions": [
      {
        "id": "2be03290-70a9-414a-a285-8c573d26de5a",
        "status": "SUCCEEDED",
        "type": "ASTROPAY_PAYOUT",
        "response_code": "SUCCEEDED",
        "purpose": null,
        "description": null,
        "amount": {
          "currency": "BRL",
          "value": 100
        },
        "withdrawal_method": {
          "type": "ASTROPAY_PAYOUT",
          "provider_id": null,
          "detail": {
            "bank_transfer": null,
            "wallet": {
              "code": "h15sg84U6rCl",
              "email": null,
              "country": null,
              "document": null,
              "phone": null
            }
          }
        },
        "provider_data": {
          "id": "ASTROPAY",
          "transaction_id": "32389",
          "account_id": "",
          "beneficiary_id": "test_merchant_deposit_id",
          "raw_response": "\"{\\n  \\\"cashout_id\\\" : 32389,\\n  \\\"merchant_cashout_id\\\" : \\\"2be03290-70a9-414a-a285-8c573d26de5a\\\",\\n  \\\"status\\\" : \\\"APPROVED\\\",\\n  \\\"user_id\\\" : \\\"h15sg84U6rCl\\\"\\n}\"",
          "status_detail": "APPROVED",
          "provider_status": null
        },
        "created_at": "2024-05-27T19:10:32.723578Z",
        "updated_at": "2024-05-27T19:10:33.757137Z"
      }
    ],
    "metadata": [],
    "created_at": "2024-05-27T19:10:32.494514Z",
    "updated_at": "2024-05-27T19:10:33.757143Z"
  }
}

Reports

report_triggers subscribes to report lifecycle events. Only report.update is currently emitted by any service; report.create can be subscribed to but has no emitter yet.

JSON

{
  "type": "report",
  "type_event": "report.update",
  "account_id": "2c05976d-1234-1234-1234-6421883de48d",
  "retry": 0,
  "version": 2,
  "data": {
    "report_id": "7b1c9d3e-5a24-4f68-9c02-3e8d1f6a4b57",
    "organization_code": "9f2e1a44-3c7b-4d15-8e60-1b4a7c9d2f88",
    "account_code": "2c05976d-1234-1234-1234-6421883de48d",
    "type": "TRANSACTIONS",
    "s3_link": "reports/ON_DEMAND/TRANSACTIONS/date=2026-08-17/organization_code=9f2e1a44-3c7b-4d15-8e60-1b4a7c9d2f88/report=7b1c9d3e-5a24-4f68-9c02-3e8d1f6a4b57/7b1c9d3e-5a24-4f68-9c02-3e8d1f6a4b57.csv",
    "merchant_reference_id": "",
    "start_date": "2026-08-01T03:00:00Z",
    "end_date": "2026-08-17T07:30:00Z",
    "created_at": "2026-08-17T07:33:04.372231Z",
    "updated_at": "2026-08-17T07:35:18.49869Z",
    "status": "SUCCEEDED",
    "user_code": ""
  }
}

Subscriptions

The next JSON object presents an example of a data structure related to a subscription.create event.

JSON

{
  "type": "subscription",
  "type_event": "subscription.create",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "8fc8a985-bc18-4f9a-9403-d0cf6fc64e94",
      "name": "Subscription",
      "description": "retries activos",
      "country": "CO",
      "account_code": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
      "merchant_reference": "subscription-ref-merchant-002",
      "status": "CREATED",
      "amount": {
        "currency": "COP",
        "value": 36000
      },
      "frequency": null,
      "billing_date": {
        "type": "DAY",
        "day": 30
      },
      "billing_cycles": {
        "total": 5,
        "current": 1,
        "next_at": "2026-02-28T18:25:49.995376Z"
      },
      "current_period_start": "2026-01-28T18:25:49.995376Z",
      "current_period_end": "2026-02-28T18:25:49.995376Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      },
      "payment_method": {
        "type": "CARD",
        "vaulted_token": "7eeb8d32-d5c3-45a8-955b-30accc625d1f"
      },
      "availability": {
        "start_at": "2026-02-01T18:25:49.995376Z",
        "finish_at": null
      },
      "retries": {
        "retry_on_decline": false,
        "amount": 6
      },
      "metadata": [
        {
          "key": "Canal 1",
          "value": "Soccer"
        }
      ],
      "additional_data": null,
      "payments": [],
      "trial_period": {
        "billing_cycles": 1,
        "amount": {
          "currency": null,
          "value": null
        }
      },
      "initial_payment_validation": true,
      "subscription_agreement_id": null,
      "created_at": "2025-05-21T15:33:16.662026Z",
      "updated_at": "2025-05-21T15:33:16.662026Z"
    }
  }
}

subscription.active

Sent when a subscription transitions from any other valid status into ACTIVE. Use this event to trigger post-activation processes without polling.

JSON

{
  "type": "subscription",
  "type_event": "subscription.active",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "description": "retries activos",
      "country": "CO",
      "account_code": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
      "merchant_reference": "subscription-ref-merchant-002",
      "status": "ACTIVE",
      "amount": {
        "currency": "COP",
        "type": "FIXED",
        "value": 36000
      },
      "frequency": {
        "type": "MINUTES",
        "value": 3,
        "monthly_billing_day": null,
        "execution": "YUNO"
      },
      "billing_date": null,
      "billing_cycles": {
        "total": 5,
        "current": 2,
        "next_at": "2025-12-04T00:32:25.485281Z"
      },
      "current_period_start": "2025-12-04T00:29:25.485281Z",
      "current_period_end": "2025-12-04T00:32:25.485281Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      },
      "payment_method": {
        "type": "CARD",
        "vaulted_token": "7eeb8d32-d5c3-45a8-955b-30accc625d1f",
        "card": {
          "installments": null,
          "network_transaction_id": "651161211088410"
        }
      },
      "availability": {
        "start_at": "2025-12-04T00:29:25.485281Z",
        "finish_at": null
      },
      "retries": {
        "retry_on_decline": true,
        "amount": 6
      },
      "metadata": [
        {
          "key": "Canal 1",
          "value": "Soccer"
        }
      ],
      "additional_data": null,
      "payments": [],
      "trial_period": {
        "billing_cycles": 1,
        "amount": {
          "currency": null,
          "value": null
        }
      },
      "initial_payment_validation": true,
      "provider_subscription_id": null,
      "subscription_agreement_id": null,
      "created_at": "2025-12-04T00:29:25.485281Z",
      "updated_at": "2025-12-04T00:29:59.216998Z"
    }
  }
}

subscription.trialing

Sent when a subscription enters a plan’s trial phase from another status. Entering the trial at creation time is reported as subscription.create, and leaving a pause into the trial as subscription.resume.

JSON

{
  "type": "subscription",
  "type_event": "subscription.trialing",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "country": "CO",
      "account_code": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
      "merchant_reference": "subscription-ref-merchant-002",
      "status": "TRIALING",
      "plan_id": "0b0a2f7a-3d19-4a52-8f0e-3f1a3d5a3f21",
      "current_phase": "TRIAL",
      "amount": {
        "currency": "COP",
        "type": "FIXED",
        "value": 36000
      },
      "billing_cycles": {
        "total": 5,
        "current": 2,
        "next_at": "2025-12-04T00:32:25.485281Z"
      },
      "current_period_start": "2025-12-04T00:29:25.485281Z",
      "current_period_end": "2025-12-04T00:32:25.485281Z",
      "current_phase_end": "2025-12-04T00:32:25.485281Z",
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      },
      "payments": [],
      "created_at": "2025-12-04T00:29:25.485281Z",
      "updated_at": "2025-12-04T00:29:59.216998Z"
    }
  }
}

subscription.past_due

Sent when a recurring charge fails and the subscription enters PAST_DUE. The subscription keeps billing while the retries run and can still be canceled. When a later charge succeeds it returns to ACTIVE — or to TRIALING if the trial phase is still running — and the corresponding subscription.active or subscription.trialing event is sent. This event is only emitted for accounts where the PAST_DUE status is enabled. Where it is not, a failed charge leaves the subscription in ACTIVE and only the payment.purchase webhook reports the decline. See Subscription Status.

JSON

{
  "type": "subscription",
  "type_event": "subscription.past_due",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "country": "CO",
      "account_code": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
      "merchant_reference": "subscription-ref-merchant-002",
      "status": "PAST_DUE",
      "amount": {
        "currency": "COP",
        "type": "FIXED",
        "value": 36000
      },
      "billing_cycles": {
        "total": 5,
        "current": 3,
        "next_at": "2025-12-04T00:35:25.485281Z"
      },
      "current_period_start": "2025-12-04T00:32:25.485281Z",
      "current_period_end": "2025-12-04T00:35:25.485281Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      },
      "retries": {
        "retry_on_decline": true,
        "amount": 6
      },
      "payments": [],
      "created_at": "2025-12-04T00:29:25.485281Z",
      "updated_at": "2025-12-04T00:35:25.485281Z"
    }
  }
}

subscription.pause

Sent when a subscription is paused. Use this event to update the status in your system and pause related services.

A paused subscription’s window is frozen where it was, not moved forward. current_period_start/current_period_end (and current_phase_end, if the subscription is inside a phase) keep whatever window was current at the moment of pause — Yuno does not advance them while billing is suspended. The longer a subscription stays paused, the further current_period_end falls into the past; on prod, the large majority of currently-paused subscriptions already show an elapsed window. Don’t treat current_period_end as “the next charge date” without also checking status — for a paused subscription it isn’t one.

JSON

{
  "type": "subscription",
  "type_event": "subscription.pause",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "PAUSED",
      "amount": {
        "currency": "COP",
        "type": "FIXED",
        "value": 36000
      },
      "billing_cycles": {
        "total": 5,
        "current": 3,
        "next_at": "2025-12-04T00:35:25.485281Z"
      },
      "current_period_start": "2025-12-04T00:32:25.485281Z",
      "current_period_end": "2025-12-04T00:35:25.485281Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    }
  }
}

subscription.resume

Sent when a paused subscription is resumed and transitions back to the ACTIVE status.

JSON

{
  "type": "subscription",
  "type_event": "subscription.resume",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Monthly Plan",
      "description": "Monthly subscription",
      "country": "US",
      "account_code": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
      "merchant_reference": "subscription-ref-merchant-002",
      "status": "ACTIVE",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 42.46
      },
      "frequency": {
        "type": "MONTH",
        "value": 1,
        "monthly_billing_day": null,
        "execution": "YUNO"
      },
      "billing_date": null,
      "billing_cycles": {
        "total": null,
        "current": 2,
        "next_at": "2026-07-14T19:19:31.914Z"
      },
      "current_period_start": "2026-06-14T19:19:31.914Z",
      "current_period_end": "2026-07-14T19:19:31.914Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      },
      "payment_method": {
        "type": "CARD",
        "vaulted_token": "4ba74a56-14d4-4161-a0ba-8036e9b8abf6",
        "card": {
          "installments": null,
          "network_transaction_id": "000000000000000",
          "usage": "USED"
        }
      },
      "availability": {
        "start_at": "2026-06-14T19:19:31.914Z",
        "finish_at": null
      },
      "retries": {
        "retry_on_decline": true,
        "amount": 4,
        "strategy": "DEFAULT",
        "schedule": null,
        "stop_on_hard_decline": null,
        "cancel_on_exhausted_retries": null
      },
      "metadata": [
        {
          "key": "plan_id",
          "value": "monthly_plan"
        }
      ],
      "additional_data": null,
      "payments": [],
      "trial_period": {
        "billing_cycles": 1,
        "amount": {
          "currency": null,
          "value": null
        }
      },
      "initial_payment_validation": false,
      "provider_subscription_id": null,
      "reason": null,
      "subscription_agreement_id": null,
      "soft_descriptor": null,
      "renewal_notification_days": null,
      "cancellation_time": null,
      "cancellation_source": null,
      "ending_time": null,
      "created_at": "2026-05-14T19:19:32.117629Z",
      "updated_at": "2026-06-15T07:11:52.504031Z",
      "history": null
    }
  }
}

subscription.cancel

Sent when a subscription is canceled. Once canceled, the subscription is terminated and cannot be reactivated. The subscription object carries a cancellation_source field describing what triggered the cancellation — MERCHANT, SYSTEM, PLAN_CHANGE, or RETRIES_EXHAUSTED. See the subscription object for what each value means.

Treat cancellation_source as open-ended. New values can be added as Yuno introduces new cancellation behaviors, so handle an unrecognized value gracefully rather than switching exhaustively over the current list. RETRIES_EXHAUSTED is the most recent addition — it is sent when retries for a billing cycle end without a successful payment on a subscription created with retries.cancel_on_exhausted_retries set to true.

JSON

{
  "type": "subscription",
  "type_event": "subscription.cancel",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "CANCELED",
      "amount": {
        "currency": "COP",
        "type": "FIXED",
        "value": 36000
      },
      "billing_cycles": {
        "total": 5,
        "current": 5,
        "next_at": "2026-01-04T00:35:25.485281Z"
      },
      "current_period_start": "2025-12-04T00:35:25.485281Z",
      "current_period_end": "2026-01-04T00:35:25.485281Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    }
  }
}

A terminal subscription reports its final billing period rather than an empty one — the pair above is frozen at whatever window was current when the subscription reached CANCELED, the same way a PAUSED subscription freezes its window (see the subscription.pause note).

subscription.complete

Sent when a subscription reaches its end date or total billing cycles and transitions to the COMPLETED status.

JSON

{
  "type": "subscription",
  "type_event": "subscription.complete",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "COMPLETED",
      "amount": {
        "currency": "COP",
        "type": "FIXED",
        "value": 36000
      },
      "billing_cycles": {
        "total": 5,
        "current": 5,
        "next_at": "2026-01-04T00:35:25.485281Z"
      },
      "current_period_start": "2025-12-04T00:35:25.485281Z",
      "current_period_end": "2026-01-04T00:35:25.485281Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    }
  }
}

subscription.close_to_renewal

Sent ahead of an upcoming renewal. Timing is controlled by renewal_notification_days on the subscription.

JSON

{
  "type": "subscription",
  "type_event": "subscription.close_to_renewal",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Monthly Plan",
      "description": "Monthly subscription",
      "country": "US",
      "account_code": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
      "merchant_reference": "subscription-ref-merchant-002",
      "status": "ACTIVE",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 42.46
      },
      "frequency": {
        "type": "MONTH",
        "value": 1,
        "monthly_billing_day": null,
        "execution": "YUNO"
      },
      "billing_date": null,
      "billing_cycles": {
        "total": null,
        "current": 2,
        "next_at": "2026-07-14T19:19:31.914Z"
      },
      "current_period_start": "2026-06-14T19:19:31.914Z",
      "current_period_end": "2026-07-14T19:19:31.914Z",
      "current_phase_end": null,
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      },
      "payment_method": {
        "type": "CARD",
        "vaulted_token": "4ba74a56-14d4-4161-a0ba-8036e9b8abf6",
        "card": {
          "installments": null,
          "network_transaction_id": "000000000000000",
          "usage": "USED"
        }
      },
      "availability": {
        "start_at": "2026-06-14T19:19:31.914Z",
        "finish_at": null
      },
      "retries": {
        "retry_on_decline": true,
        "amount": 4,
        "strategy": "DEFAULT",
        "schedule": null,
        "stop_on_hard_decline": null,
        "cancel_on_exhausted_retries": null
      },
      "metadata": [
        {
          "key": "plan_id",
          "value": "monthly_plan"
        }
      ],
      "additional_data": null,
      "payments": [],
      "trial_period": {
        "billing_cycles": 1,
        "amount": {
          "currency": null,
          "value": null
        }
      },
      "initial_payment_validation": false,
      "provider_subscription_id": null,
      "reason": null,
      "subscription_agreement_id": null,
      "soft_descriptor": null,
      "renewal_notification_days": 3,
      "cancellation_time": null,
      "cancellation_source": null,
      "ending_time": null,
      "created_at": "2026-05-14T19:19:32.117629Z",
      "updated_at": "2026-06-15T07:11:52.504031Z",
      "history": null
    }
  }
}

subscription.cycle_executed

Sent for plan-based subscriptions when a $0 cycle is executed, either a trial cycle or a fully discounted one. Those cycles produce no payment.purchase webhook, so this event is the only receipt for them. reason is TRIAL or FULL_DISCOUNT, phase is the phase the cycle belongs to, and breakdown carries the same line-item detail as a paid cycle, with a zero total.

JSON

{
  "type": "subscription",
  "type_event": "subscription.cycle_executed",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Monthly Plan",
      "status": "TRIALING",
      "plan_id": "0b0a2f7a-3d19-4a52-8f0e-3f1a3d5a3f21",
      "current_phase": "TRIAL",
      "billing_cycles": {
        "total": null,
        "current": 2,
        "next_at": "2026-07-14T19:19:31.914Z"
      },
      "current_period_start": "2026-06-14T19:19:31.914Z",
      "current_period_end": "2026-07-14T19:19:31.914Z",
      "current_phase_end": "2026-07-14T19:19:31.914Z",
      "payments": []
    },
    "cycle": 1,
    "reason": "TRIAL",
    "phase": "TRIAL",
    "plan_id": "0b0a2f7a-3d19-4a52-8f0e-3f1a3d5a3f21",
    "phase_payment": 1,
    "billing_cycle": 1,
    "breakdown": {
      "currency": "USD",
      "subtotal": 0,
      "total": 0,
      "plan_id": "0b0a2f7a-3d19-4a52-8f0e-3f1a3d5a3f21",
      "line_items": [
        {
          "type": "PLAN",
          "label": "Trial",
          "service_period": {
            "start": "2026-06-14T19:19:31.914Z",
            "end": "2026-07-14T19:19:31.914Z"
          },
          "amount": {
            "currency": "USD",
            "value": 0
          }
        }
      ]
    }
  }
}

subscription.phase_completed

Sent for plan-based subscriptions when a billing phase ends, immediately before the subscription.phase_started of the phase that replaces it. It is not sent for the first phase, which has no predecessor. phase is the phase that just ended.

JSON

{
  "type": "subscription",
  "type_event": "subscription.phase_completed",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Monthly Plan",
      "status": "ACTIVE",
      "plan_id": "0b0a2f7a-3d19-4a52-8f0e-3f1a3d5a3f21",
      "current_phase": "REGULAR",
      "payments": []
    },
    "phase": "TRIAL"
  }
}

subscription.phase_started

Sent for plan-based subscriptions when a billing phase begins, including the first one. phase is the phase that is starting and previous_phase is the one it replaces, or null for the first phase.

JSON

{
  "type": "subscription",
  "type_event": "subscription.phase_started",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Monthly Plan",
      "status": "ACTIVE",
      "plan_id": "0b0a2f7a-3d19-4a52-8f0e-3f1a3d5a3f21",
      "current_phase": "REGULAR",
      "payments": []
    },
    "phase": "REGULAR",
    "previous_phase": "TRIAL"
  }
}

subscription.plan_change_scheduled

Sent when a plan change is scheduled for the next billing cycle. The plan_change block describes the pending change; applies_at is the next billing date the change will take effect on.

JSON

{
  "type": "subscription",
  "type_event": "subscription.plan_change_scheduled",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "ACTIVE",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 9.99
      },
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    },
    "plan_change": {
      "plan_id": "1904911d-5df9-429e-8488-ad41abea1a4d",
      "plan_name": "Pro",
      "direction": "UPGRADE",
      "effective": "NEXT_BILLING_CYCLE",
      "phases_behavior": "START_FROM_REGULAR",
      "applies_at": "2026-08-15T00:00:00Z",
      "requested_at": "2026-07-28T14:02:11Z"
    }
  }
}

subscription.plan_change_canceled

Sent when a pending plan change is undone or aborted. The reason inside plan_change is MERCHANT_UNDO when the merchant sent "plan_change": null, or TARGET_PLAN_CANCELED when the target plan was canceled before the change applied — the subscription stays on its current plan in both cases. If the subscription itself is canceled, the pending change is silently discarded and only subscription.cancel is sent.

JSON

{
  "type": "subscription",
  "type_event": "subscription.plan_change_canceled",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "ACTIVE",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 9.99
      },
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    },
    "plan_change": {
      "plan_id": "1904911d-5df9-429e-8488-ad41abea1a4d",
      "plan_name": "Pro",
      "reason": "MERCHANT_UNDO"
    }
  }
}

subscription.plan_changed

Sent when a plan change takes effect. previous_plan_id identifies the plan the subscription moved away from; the embedded subscription already reflects the new plan. A scheduled change is applied at the renewal that first bills the new plan, in place — the embedded subscription keeps the same code. POST /v1/subscriptions/{id}/plan instead replaces the subscription: the payload carries a new code with previous_subscription_id set, and a separate subscription.cancel (cancellation_source: PLAN_CHANGE) fires for the original.

JSON

{
  "type": "subscription",
  "type_event": "subscription.plan_changed",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "ACTIVE",
      "plan_id": "1904911d-5df9-429e-8488-ad41abea1a4d",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 29.99
      },
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    },
    "previous_plan_id": "0804911d-5df9-429e-8488-ad41abea1a4c"
  }
}

subscription.cancel_scheduled

Sent when a cancellation is scheduled via POST /v1/subscriptions/{id}/cancel with a schedule block. cancel_scheduled describes the pending schedule — see Cancel Subscription.

JSON

{
  "type": "subscription",
  "type_event": "subscription.cancel_scheduled",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "ACTIVE",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 9.99
      },
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    },
    "cancel_scheduled": {
      "mode": "AFTER_CYCLES",
      "after_cycles": 3,
      "at": "<example>",
      "requested_at": "<example>",
      "past_due_behavior": "EXHAUST_RETRIES"
    }
  }
}

subscription.cancel_schedule_canceled

Sent when a pending scheduled cancellation is undone via "schedule": null on POST /v1/subscriptions/{id}/cancel. Not sent when the schedule instead fires — subscription.cancel fires then.

JSON

{
  "type": "subscription",
  "type_event": "subscription.cancel_schedule_canceled",
  "account_id": "c24d6c92-99a7-40bb-bc7b-efc40337f9f4",
  "retry": 0,
  "version": 2,
  "data": {
    "subscription": {
      "code": "e98ef674-9baa-4f7a-8da4-4c812c4749a4",
      "name": "Subscription",
      "status": "ACTIVE",
      "amount": {
        "currency": "USD",
        "type": "FIXED",
        "value": 9.99
      },
      "customer_payer": {
        "code": "a9f9140a-1216-481c-8356-1a125078f905"
      }
    }
  }
}

Renewal charges and failures (no `subscription.error`)

There is no subscription.error webhook. Yuno does not emit a subscription event when a renewal charge fails. Renewal-charge outcomes, both successful rebills and failed or declined attempts, are delivered as payment.purchase webhooks tied to the subscription, with the result carried in the status/sub_status fields. Subscribe to payment.purchase to track renewal results. $0/trial cycles emit no payment webhook; on plan-based subscriptions they are reported as subscription.cycle_executed instead.

The renewal charge itself is always signaled by a payment.purchase webhook, never by a subscription webhook. The payments array inside the subscription object is currently always empty in webhook payloads. subscription.active is sent when the subscription first becomes active (at billing_cycles.current = 2), not on every renewal — it is sent again only when a subscription recovers from PAST_DUE.

A failed renewal does produce a subscription webhook in two cases. Where the PAST_DUE status is enabled for the account, the first failed charge of a cycle moves the subscription to PAST_DUE and emits subscription.past_due. And if the subscription has retries.cancel_on_exhausted_retries set to true, then once retries for that cycle end without a successful payment the subscription is canceled and a single subscription.cancel is emitted with cancellation_source set to RETRIES_EXHAUSTED. This is still not a subscription.error — the individual failed attempts remain payment.purchase webhooks. Only the final cancellation is signaled on the subscription.

Onboardings

The next JSON object presents an example of a data structure related to an onboarding event, in this case onboarding.error.

Example

{
    "type": "onboarding",
    "type_event": "onboarding.error",
    "account_id": "c2721496-89c3-497a-8e24-0872c2e1386c",
    "retry": 0,
    "version": 2,
    "data": {
        "id": "d1fbb1d7-321d-4855-b603-135cd4f4ab82",
        "type": "TWO_STEP_ONBOARDING",
        "workflow": "DIRECT",
        "description": null,
        "status": "ERROR",
        "response_message": null,
        "callback_url": "https://merchant.example.com/webhook/onboarding",
        "provider": {
            "id": "STRIPE",
            "connection_id": "caaeba00-05c8-4295-815f-1736c2b0b622",
            "redirect_url": null,
            "recipient_id": "",
            "onboarding_url": "",
            "legal_entity": null
        },
        "documentation": [],
        "legal_representatives": [],
        "withdrawal_methods": {
            "bank": {
                "code": "002",
                "branch": "002",
                "branch_digit": null,
                "account": "9876543210",
                "account_digit": null,
                "account_type": "CHECKINGS",
                "routing": "021000022",
                "country": "US",
                "currency": "USD",
                "payout_schedule": null
            }
        },
        "requirements": [
            {
                "field": "withdrawal_methods.bank.routing",
                "message": "Invalid routing number",
                "status": "REJECTED"
            }
        ],
        "terms_of_service": null,
        "metadata": [],
        "recipient": {
            "id": "c5e0d5d5-5346-4fea-9b3e-97e825b11b07",
            "national_entity": "INDIVIDUAL",
            "merchant_recipient_id": "12b2b154-3ac9-4255-848a-46c8e3a70476",
            "entity_type": "PRIVATE",
            "first_name": "Juan",
            "last_name": "Pérez",
            "legal_name": null,
            "email": "juan.perez@example.com",
            "date_of_birth": "1990-01-15",
            "country": "CO",
            "website": "https://juanperez.com",
            "industry": "Technology",
            "merchant_category_code": "5734",
            "document": {
                "document_number": "1234567890",
                "document_type": "CC"
            },
            "phone": {
                "country_code": "57",
                "number": "3001234567"
            },
            "address": {
                "address_line_1": "Carrera 7 # 32-16",
                "address_line_2": "Oficina 201",
                "city": "Bogotá",
                "country": "CO",
                "state": "Cundinamarca",
                "zip_code": "110311",
                "neighborhood": "Centro"
            },
            "withdrawal_methods": {
                "bank": {
                    "code": "001",
                    "branch": "004",
                    "branch_digit": "123",
                    "account": "1234567890",
                    "account_digit": "123",
                    "account_type": "SAVINGS",
                    "routing": "021000021",
                    "country": "CO",
                    "currency": "COP",
                    "payout_schedule": null
                }
            },
            "documentation": [],
            "legal_representatives": [
                {
                    "merchant_reference": "REP_001",
                    "first_name": "María",
                    "last_name": "González",
                    "email": "maria.gonzalez@example.com",
                    "date_of_birth": "1985-05-20",
                    "country": "CO",
                    "nationality": "CO",
                    "title": "CEO",
                    "publicly_exposed_person": false,
                    "ultimate_beneficial_owner": true,
                    "document": {
                        "document_number": "0987654321",
                        "document_type": "CC"
                    },
                    "phone": {
                        "country_code": "+57",
                        "number": "3109876543"
                    },
                    "address": {
                        "address_line_1": "Calle 26 # 13-19",
                        "address_line_2": null,
                        "city": "Bogotá",
                        "country": "CO",
                        "state": "Cundinamarca",
                        "zip_code": "110311",
                        "neighborhood": null
                    }
                }
            ],
            "created_at": "2025-10-21T16:29:36.997492Z",
            "updated_at": "2025-10-21T16:29:36.997505Z"
        },
        "created_at": "2025-10-21T16:29:41.88055Z",
        "updated_at": "2025-10-21T16:29:42.571531Z",
        "expires_at": null
    }
}

Marketplace Split Transfers

Standalone transfer notifications include the saved direction at the top level of the delivered JSON body. Existing transfers use PLATFORM_TO_RECIPIENT. Recipient-to-platform availability follows the create endpoint. The examples below show selected fields from the delivered body. The headings are the subscription event types; the delivered body is the transfer object itself, without an envelope and without an event-type field. Identify a reversal notification by its status (REVERSED or REVERSED_PARTIAL) and by a transaction of type SPLIT_TRANSFER_REVERSE. provider_data describes the provider account that processed the transfer; each transaction’s raw_response carries the provider’s raw response, JSON-serialized as a string.

Per engineering, the type_event these two events are recorded under internally is transfer.transfer — the delivered webhook body itself carries no type/type_event envelope, as noted above.

split_transfer.succeeded

Sent when a marketplace split transfer completes successfully.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "recipient_id": "d246d578-266c-47c3-92b6-1748d780711b",
  "direction": "PLATFORM_TO_RECIPIENT",
  "amount": {
    "currency": "USD",
    "value": 4
  },
  "status": "SUCCEEDED",
  "description": "Weekly marketplace earnings",
  "merchant_reference": null,
  "metadata": null,
  "provider_data": {
    "id": "STRIPE",
    "recipient_id": "acct_1H2c3d4E5f6G7h8I",
    "transfer_id": "tr_example",
    "response_code": null,
    "response_message": null
  },
  "transactions": [
    {
      "code": "cb5fd244-90fd-49b0-a160-a9d9f764eb9e",
      "type": "SPLIT_TRANSFER",
      "status": "SUCCEEDED",
      "parent_transaction_code": null,
      "provider_transfer_id": "tr_example",
      "provider_response_code": null,
      "provider_response_message": null,
      "raw_response": "{\"id\":\"tr_example\",\"status\":\"paid\"}",
      "reason": null,
      "created_at": "2026-09-15T10:00:00Z",
      "updated_at": "2026-09-15T10:00:00Z"
    }
  ],
  "created_at": "2026-09-15T10:00:00Z",
  "updated_at": "2026-09-15T10:00:00Z",
  "completed_at": "2026-09-15T10:00:00Z"
}

split_transfer_reverse.succeeded

The notification identifies the original transfer, retains its direction, and includes both the original and reversal transactions. In this partial-reversal example, status is REVERSED_PARTIAL and amount is the USD 1 reversal amount. The reversal transaction points to the original transaction through parent_transaction_code. This notification is distinct from the reversal HTTP response, which does not include direction. It is delivered under the original transfer’s id; description and merchant_reference carry the values sent in the reverse request.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "recipient_id": "d246d578-266c-47c3-92b6-1748d780711b",
  "direction": "PLATFORM_TO_RECIPIENT",
  "amount": {
    "currency": "USD",
    "value": 1
  },
  "status": "REVERSED_PARTIAL",
  "description": "Reversal due to order cancelled",
  "merchant_reference": "reverse-merchant-ref",
  "metadata": null,
  "provider_data": {
    "id": "STRIPE",
    "recipient_id": "acct_1H2c3d4E5f6G7h8I",
    "transfer_id": "trr_example",
    "response_code": null,
    "response_message": null
  },
  "transactions": [
    {
      "code": "cb5fd244-90fd-49b0-a160-a9d9f764eb9e",
      "type": "SPLIT_TRANSFER",
      "status": "SUCCEEDED",
      "parent_transaction_code": null,
      "provider_transfer_id": "tr_example",
      "provider_response_code": null,
      "provider_response_message": null,
      "raw_response": "{\"id\":\"tr_example\",\"status\":\"paid\"}",
      "reason": null,
      "created_at": "2026-09-15T10:00:00Z",
      "updated_at": "2026-09-15T10:00:00Z"
    },
    {
      "code": "0e5b4d60-4811-4a48-90c1-398d28dbce8c",
      "type": "SPLIT_TRANSFER_REVERSE",
      "status": "SUCCEEDED",
      "parent_transaction_code": "cb5fd244-90fd-49b0-a160-a9d9f764eb9e",
      "provider_transfer_id": "trr_example",
      "provider_response_code": null,
      "provider_response_message": null,
      "raw_response": "{\"id\":\"trr_example\",\"status\":\"reversed\"}",
      "reason": "ORDER_CANCELLED",
      "created_at": "2026-09-15T10:05:00Z",
      "updated_at": "2026-09-15T10:05:00Z"
    }
  ],
  "created_at": "2026-09-15T10:00:00Z",
  "updated_at": "2026-09-15T10:05:00Z",
  "completed_at": "2026-09-15T10:05:00Z"
}

Refunds

The next JSON object presents an example of a data structure related to a payment.refund event.

Example

{
  "type": "payment",
  "type_event": "payment.refund",
  "account_id": "2e7bc710-32db-43b2-a7aa-21c3bd031f8f",
  "retry": 0,
  "version": 2,
  "data": {
    "payment": {
    "code": "f7bcf40d-7255-4e13-9dba-df6fa09be6b2",
    "id": "f7bcf40d-7255-4e13-9dba-df6fa09be6b2",
    "idempotency_key": "49eda7f2-bb05-437f-9676-7c8bb6df94a9",
    "organization_code": "c60f4657-6ec5-487c-b9d5-a5fdbc887a1f",
    "account_code": "2e7bc710-32db-43b2-a7aa-21c3bd031f8f",
    "account_id": "2e7bc710-32db-43b2-a7aa-21c3bd031f8f",
    "description": "Test goold",
    "country": "CO",
    "status": "REFUNDED",
    "sub_status": "REFUNDED",
    "order_id": "0000023",
    "merchant_order_id": "0000023",
    "created_at": "2025-09-03T21:51:08.633533Z",
    "updated_at": "2025-09-03T21:53:40.368707Z",
    "amount": {
      "currency": "COP",
      "value": 30000,
      "refunded": 30000,
      "captured": 0,
      "currency_conversion": {
        "code": "ccv_01HVK3Z9M2...",
        "cardholder_currency": "USD",
        "cardholder_amount": 7.50,
        "cardholder_accepted": true,
        "rate": 4000.00,
        "rate_margin_percentage": 3.0,
        "rate_source": "BLOOMBERG",
        "provider": "PLANET",
        "description": "DCC quote for retail shopping.",
        "created_at": "2026-04-24T14:30:00Z",
        "expires_at": "2026-04-24T15:30:00Z",
        "status": "APPLIED",
        "error_reason": null,
        "provider_data": {
          "terminal_id": "TERM_99"
        }
      }
    },
    "checkout": {
      "session": null,
      "sdk_action_required": false
    },
    "customer_payer": {
      "code": "1ca7351f-8855-4765-bbe5-bd5110809cf2",
      "id": "1ca7351f-8855-4765-bbe5-bd5110809cf2",
      "organization_customer_external_id": "1756936266",
      "merchant_customer_id": "1756936266",
      "first_name": "Willintong",
      "last_name": "Ramirez",
      "gender": "M",
      "date_of_birth": "1990-02-28",
      "email": "willintong.ramirez@y.uno",
      "nationality": "AR",
      "ip_address": null,
      "device_fingerprint": null,
      "third_party_session_id": null,
      "device_fingerprints": [],
      "browser_info": null,
      "document": {
        "document_number": "123554332",
        "document_type": "PASS"
      },
      "billing_address": {
        "address_line_1": "Calle 34 # 56 - 78",
        "address_line_2": "Apartamento 502, Torre I",
        "city": "Bogotá",
        "country": "CO",
        "state": "Cundinamarca",
        "zip_code": "111111",
        "neighborhood": null
      },
      "shipping_address": {
        "address_line_1": "Calle 34 # 56 - 78",
        "address_line_2": "Apartamento 502, Torre I",
        "city": "Bogotá",
        "country": "CO",
        "state": "Cundinamarca",
        "zip_code": "111111",
        "neighborhood": null
      },
      "phone": {
        "country_code": "57",
        "number": "3132450765"
      },
      "merchant_customer_created_at": null,
      "geo_location": {
        "latitude": null,
        "longitude": null
      },
      "merchant_customer_validations": {
        "account_is_verified": true,
        "email_is_verified": true,
        "phone_is_verified": true
      }
    },
    "additional_data": {
      "order": {
        "shipping_amount": 10.35,
        "fee_amount": 40.5,
        "tip_amount": null,
        "items": [
          {
            "id": "123AD",
            "name": "Skirt",
            "quantity": 3,
            "unit_amount": 20,
            "category": "Clothes",
            "brand": "XYZ",
            "sku_code": "8765432109",
            "manufacture_part_number": "XYZ123456",
            "image_url": null
          }
        ],
        "taxes": [],
        "shipping": null,
        "account_funding": null,
        "tickets": [],
        "fulfillment": null,
        "discounts": [],
        "sales_channel": null
      },
      "airline": null,
      "transportations": null,
      "seller_details": null
    },
    "transactions": {
      "code": "14a2ca8a-07bd-47b2-9070-4868ab176ac8",
      "id": "14a2ca8a-07bd-47b2-9070-4868ab176ac8",
      "type": "REFUND",
      "status": "SUCCEEDED",
      "category": "CARD",
      "amount": 30000,
      "provider_id": "YUNO_TEST_PAYMENT_GW",
      "response_code": "SUCCEEDED",
      "merchant_reference": "REFUND_001",
      "response_message": "Transaction successful",
      "reason": "REQUESTED_BY_CUSTOMER",
      "description": "Test refund",
      "created_at": "2025-09-03T21:53:40.230290Z",
      "updated_at": "2025-09-03T21:53:40.346884Z",
      "payment_method": {
        "token": null,
        "type": "CARD",
        "vaulted_token": null,
        "vault_on_success": false,
        "parent_payment_method_type": null,
        "payment_method_detail": {
          "card": {
            "verify": false,
            "capture": false,
            "installments": 1,
            "installments_plan_id": null,
            "first_installment_deferral": null,
            "installments_amount": null,
            "installments_type": null,
            "soft_descriptor": "",
            "authorization_code": "658571",
            "retrieval_reference_number": "",
            "acquirer_reference_number": "",
            "voucher": null,
            "card_data": {
              "holder_name": "Pepito Perez",
              "iin": "41111111",
              "lfd": "1111",
              "number_length": 16,
              "security_code_length": 3,
              "brand": "VISA",
              "issuer_name": "CONOTOXIA SP Z O O",
              "issuer_code": null,
              "country_code": "PL",
              "category": "CLASSIC",
              "type": "DEBIT",
              "three_d_secure": {
                "version": null,
                "electronic_commerce_indicator": null,
                "cryptogram": null,
                "transaction_id": null,
                "directory_server_transaction_id": null,
                "pares_status": null,
                "acs_id": null,
                "strong_customer_authentication_exemptions": null
              },
              "network_token": null,
              "fingerprint": "3d49ec9d-e941-4eaf-80eb-251469d66108",
              "expiration_month": 3,
              "expiration_year": 26
            },
            "stored_credentials": {
              "reason": null,
              "usage": null,
              "subscription_agreement_id": null,
              "network_transaction_id": null
            }
          },
          "wallet": null,
          "bnpl": null,
          "bank_transfer": null,
          "ticket": null,
          "payment_link": null
        }
      },
      "provider": {
        "provider_transaction_id": "a9908f18-71ca-458b-9f94-f63e55bdc94a"
      },
      "provider_data": {
        "raw_response": {
          "message": "provider response"
        },
        "id": "YUNO_TEST_PAYMENT_GW",
        "transaction_id": "a9908f18-71ca-458b-9f94-f63e55bdc94a",
        "account_id": null,
        "status": null,
        "status_detail": null,
        "response_message": null,
        "response_code": "SUCCEEDED",
        "third_party_transaction_id": null,
        "third_party_account_id": null,
        "iso8583_response_code": null,
        "iso8583_response_message": null
      },
      "connection_data": {
        "id": null,
        "name": null
      },
      "simplified_mode": false,
      "third_party_session_id": null,
      "receipt": false,
      "receipt_language": null,
      "receipt_url": null,
      "device_fingerprint": null
    },
    "transactions_history": [],
    "callback_url": null,
    "workflow": "DIRECT",
    "split_marketplace": [],
    "payment_link_code": "",
    "subscription_id": null,
    "subscription": null,
    "fraud_screening": null,
    "metadata": [],
    "routing_rules": {
      "smart_routing": false,
      "monitors": false,
      "condition": {
        "id": 148781,
        "name": null,
        "description": null
      }
    }
    }
  }
}

HMAC - Authorization

The next example shows a raw webhook request with the x-hmac-signature header Yuno includes when HMAC authentication is enabled.

POST /your-webhook-endpoint HTTP/1.1
Host: your-server.com
Content-Type: application/json
x-api-key: your-api-key
x-secret: your-secret
x-hmac-signature: YwPQ1b2RcBkDGo32XvDS7R+/nMDuDIRjvQlsak72EMBY=

{
  "live": "false",
  "notificationItems": [
    {
      "NotificationRequestItem": {
        "additionalData": {
          "expiryDate": "12/2012",
          "authCode": "1234",
          "cardSummary": "7777",
          "totalFraudScore": "10"
        },
        "amount": {
          "currency": "EUR",
          "value": 10100
        },
        "eventCode": "AUTHORISATION",
        "eventDate": "2022-11-15T20:04:11+01:00",
        "merchantAccountCode": "AcmeCorp",
        "merchantReference": "2931874530016873",
        "paymentMethod": "visa",
        "pspReference": "CU4KVBAYAPFG0ZZKR",
        "success": "true"
      }
    }
  ]
}

​Webhook attributes

​Split update webhooks

​Examples

Payment Webhook V2

Payment Webhook V1

Chargeback Webhook V2

Chargeback Webhook V1

Enrollment

Payouts

Subscriptions

Onboardings

Refunds

Marketplace Split Transfers

HMAC - Authorization

​Payment

​Payment Webhook V2

​Payment Webhook V1

​Chargeback Webhook V2

​Chargeback Webhook V1

​payment.pre_chargeback

​Enrollment

​Payouts

​Reports

​Subscriptions

​subscription.active

​subscription.trialing

​subscription.past_due

​subscription.pause

​subscription.resume

​subscription.cancel

​subscription.complete

​subscription.close_to_renewal

​subscription.cycle_executed

​subscription.phase_completed

​subscription.phase_started

​subscription.plan_change_scheduled

​subscription.plan_change_canceled

​subscription.plan_changed

​subscription.cancel_scheduled

​subscription.cancel_schedule_canceled

​Renewal charges and failures (no subscription.error)

​Onboardings

​Marketplace Split Transfers

​split_transfer.succeeded

​split_transfer_reverse.succeeded

​Refunds

​HMAC - Authorization

Webhook attributes

Split update webhooks

Examples

Payment

Payment Webhook V2

Payment Webhook V1

Chargeback Webhook V2

Chargeback Webhook V1

payment.pre_chargeback

Enrollment

Payouts

Reports

Subscriptions

subscription.active

subscription.trialing

subscription.past_due

subscription.pause

subscription.resume

subscription.cancel

subscription.complete

subscription.close_to_renewal

subscription.cycle_executed

subscription.phase_completed

subscription.phase_started

subscription.plan_change_scheduled

subscription.plan_change_canceled

subscription.plan_changed

subscription.cancel_scheduled

subscription.cancel_schedule_canceled

Renewal charges and failures (no `subscription.error`)

Onboardings

Marketplace Split Transfers

split_transfer.succeeded

split_transfer_reverse.succeeded

Refunds

HMAC - Authorization