Webhook attributes
The JSON attributes for Yuno webhooks are listed below: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
Show properties
string
Identifier used to skip duplicate deliveries. It stays stable across every retry of the same event. 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.
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.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.{
"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"
}
},
"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": []
},
"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
}
}
}
}
}
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"
}
},
"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":"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":[
]
}
}
Enrollment
{
"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"
}
}
}
}
}
Payouts
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"
}
}
Subscriptions
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"
},
"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 intoACTIVE. 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"
},
"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.pause
Sent when a subscription is paused. Use this event to update the status in your system and pause related services.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
},
"customer_payer": {
"code": "a9f9140a-1216-481c-8356-1a125078f905"
}
}
}
}
subscription.resume
Sent when a paused subscription is resumed and transitions back to theACTIVE 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"
},
"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 acancellation_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
},
"customer_payer": {
"code": "a9f9140a-1216-481c-8356-1a125078f905"
}
}
}
}
subscription.complete
Sent when a subscription reaches its end date or total billing cycles and transitions to theCOMPLETED 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
},
"customer_payer": {
"code": "a9f9140a-1216-481c-8356-1a125078f905"
}
}
}
}
subscription.close_to_renewal
Sent ahead of an upcoming renewal. Timing is controlled byrenewal_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"
},
"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.plan_change_scheduled
Sent when a plan change is scheduled for the next billing cycle. Theplan_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. Thereason 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"
}
}
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 — successful rebills and failed/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.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 once (at billing_cycles.current = 2), not on every renewal.There is one case where a failed renewal does produce a subscription webhook. 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
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
split_transfer.succeeded
{
"type": "split_transfer",
"type_event": "succeeded",
"trace_id": "abc123",
"transfer_id": "TRF_7kB2mQ9xPnL4vR",
"account_id": "2c05976d-1234-1234-1234-6421883de48d",
"retry": 0,
"version": 1,
"data": {
"id": "TRF_7kB2mQ9xPnL4vR",
"recipient_id": "550e8400-e29b-41d4-a716-446655440000",
"amount": {
"currency": "USD",
"value": 150.00
},
"status": "SUCCEEDED",
"description": "Weekly marketplace earnings",
"merchant_reference": "TRANSFER-2026-02-15-001",
"metadata": [],
"provider": "adyen",
"transactions": [
{
"code": "7ac2c5f3-7c79-4e99-b45e-aa5952620188",
"type": "SPLIT_TRANSFER",
"status": "SUCCEEDED",
"provider_transfer_id": "tr_1T9eKVIiMnPsFcbbRTb8ObsZ",
"created_at": "2026-03-11T04:25:06.229027Z",
"updated_at": "2026-03-11T04:25:07.917364Z"
}
],
"created_at": "2026-03-11T04:25:06.208761Z",
"updated_at": "2026-03-11T04:25:07.928000342Z",
"completed_at": "2026-03-11T04:25:07.927971142Z"
}
}
split_transfer_reverse.succeeded
{
"type": "split_transfer_reverse",
"type_event": "succeeded",
"trace_id": "xyz789",
"transfer_id": "TRF_7kB2mQ9xPnL4vR",
"account_id": "2c05976d-1234-1234-1234-6421883de48d",
"retry": 0,
"version": 1,
"data": {
"id": "TRF_REV_9xPnL4vR7kB2mQ",
"recipient_id": "550e8400-e29b-41d4-a716-446655440000",
"amount": {
"currency": "USD",
"value": 50.00
},
"status": "SUCCEEDED",
"description": "Reversal of partial earnings",
"merchant_reference": "REVERSE-2026-02-16-001",
"metadata": [],
"provider": "adyen",
"transactions": [
{
"code": "8bd3d6f4-8d80-5f00-c56f-bb6063731299",
"type": "SPLIT_TRANSFER_REVERSE",
"status": "SUCCEEDED",
"provider_transfer_id": "tr_2U0fLWIjNoQtGdccSUc9PbtA",
"created_at": "2026-03-12T05:26:07.229027Z",
"updated_at": "2026-03-12T05:26:08.917364Z"
}
],
"created_at": "2026-03-12T05:26:07.208761Z",
"updated_at": "2026-03-12T05:26:08.928000342Z",
"completed_at": "2026-03-12T05:26:08.927971142Z"
}
}
Refunds
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
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"
}
}
]
}