Webhook attributes
The JSON attributes for Yuno webhooks are listed below:The unique identifier of the account in Yuno (MAX 64; MIN 36).
Specifies the notification type.
Specifies the event notification type.
Specifies the version of the webhook sent. Currently 2.
Specifies the number of retries for that notification.
Specifies the payment (for payment type) or payment method object (for enrollment and other objects).
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
The next JSON object presents an example of a data structure related to a payment event from Webhook V2.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.{
"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": "",
"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": ""
},
"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": "",
"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": ""
},
"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
The next JSON object presents an example of a data structure related to a payment event from Webhook V1.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":"",
"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"
}
},
"callback_url":null,
"workflow":"CHECKOUT",
"split":[
],
"subscription_id":null,
"payment_link_id":null
}
}
Chargeback Webhook V2
The next JSON object presents an example of a data structure related to a payment event from Webhook V2.{
"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":"",
"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":"",
"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":"",
"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
The next JSON object presents an example of a data structure related to a payment event from Webhook V1.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":"",
"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
},
"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.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
},
"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
}
}
}
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.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": "",
"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"
}
}
]
}