Transaction Webhooks

`transaction.success`

Transaction type soportados en Chile para `transaction.success`

Transaction type 🇨🇱	Detalle
card	Pago con tarjetas (recurrentes y onetime)
transfer	Transferencias bancarias y botones bancarios
pac_management	Gestión de PAC (incluye a Débito Directo)
cash	Integración con Servipag

Transaction type soportados en México `transaction.success`

Transaction type 🇲🇽	Detalle
card	Pago con tarjetas
transfer	Transferencias bancarias
cash	Integración con Servipag
wallet	Movimientos de billetera digital (paypal)

Información sobre un pago exitoso.

{
  "id": "whe_hXPK3YBs4EUfw2KFZlB6R44MiFa07vFU",
  "event_type": "transaction.success",
  "transaction": {
    "id": "trs_rInqjZCm4O3O48rqfEw3k9JH-R9uLLLZ",
    "type": "PAYMENT",
    "amount": "5246.0000",
    "currency": "CLP",
    "transaction_date": "2024-04-30T19:01:41.733489",
    "status": "SUCCESS",
    "response_code": "SUTOK0000",
    "voucher": null
  },
  "payment_instrument": {
    "type": "...",
    "card": {...},
    "transfer": {...},
    "cash": {...},
    "wallet": {...}
  },
  "customer": {
    "id": "cus_SqTQO486U9o5LhXQjN8_saZmZsyUltoh",
    "external_id": "106056161-3520308",
    "email": "fsimmons@example.com",
    "government_id": "106056161",
    "name": "Claudio Arenas",
    "phone_number": "+56#########"
  },
  "payment_intents": [
    {
      "id": "pi_8QUrs7ozSqnX1xr0fGqqqreOmEcl-7s7",
      "amount": "5146.0000",
      "currency": "CLP",
      "id_invoice": "in_8QUrs7ozSqnX1xr0fGqqqreOmEcl-7s7",
      "id_subscription": "sub_8QUrs7ozSqnX1xr0fGqqqreOmEcl-7s7",
      "invoice_external_id": null,
      "gateway": "",
      "price_change_amount": "0.00",
      "product_id": "product_id_10",
      "status": "AUTHORIZED",
      "type": "one_time"
    }
  ],
  "wallet_movements": [
    {
      "id": "wmv_rInqjZCm4O3O48rqfEw3k9JH-R9uLLLZ",
      "type": "SURPLUS",
      "amount": 100.00
    }
  ]
}

El campo type en payment_instrument indica el método de pago utilizado para la transacción. La información del método de pago se encontrará en el campo con nombre igual al valor de type en payment_instrument.

🇨🇱`transaction.failed`

Transaction type sportados en Chile para `transaction.failed`

Transaction type 🇨🇱	Detalle
transfer	Transferencias bancarias y botones bancarios

🚧
Para el caso de las transacciones type: card, pac_management y cash se está trabajando en implementar este webhook

Información sobre un pago fallido

{
  "id": "wheve_FEtKHJMKLFKJnrtxDHnM8o_M5JabacIC",
  "event_type": "transaction.failed",
  "transaction": {
    "id": "trs_jMMNl5DIAXne0oi6nl2DhFec7fa6pSet",
    "type": "PAYMENT",
    "amount": "15.0000",
    "currency": "CLP",
    "transaction_date": "2025-07-04 14:54:10.658079",
    "status": "FAILED",
    "transaction_metadata": {
      "buy_order": "1445408504730000"
    },
    "response_code": null,
    "voucher": null,
    "id_checkout_session": null,
    "external_id": null,
    "id_payout": null,
    "original_response_message": null
  },
  "customer": {
    "id": "cus_KtOcpyMbNwg31tXeMXGKv4Xz6L8i4E3R",
    "external_id": "195552015",
    "email": null,
    "government_id": "195552015",
    "name": "Antonio Stark",
    "phone_number": null
  },
  "payment_intents": [
    {
      "id": "pi_RxbYiBXUljw4047PIV1yhvgEOa1hwZIM",
      "amount": "15.0000",
      "currency": "CLP",
      "id_invoice": "in_rbX1wDNp_1pYAnVsMjJNn_arCRY1khfE",
      "id_subscription": "sub_jW2elQxHzSEHytiSN463DauELmgKr_qx",
      "invoice_external_id": "test-toku-transfer-2025-01-01",
      "id_account": "acc_46spPHnwxkdG56oezATsJyJuEzF_sx_4",
      "gateway": "pb_transfer_cl_banco_de_chile",
      "price_change_amount": "0.0000",
      "product_id": "test-toku-transfer",
      "status": "ABORTED",
      "type": "one_time"
    }
  ],
  "payment_instrument": {
    "type": "transfer",
    "card": null,
    "transfer": {
      "country": "Chile",
      "institution_id": "cl_banco_de_chile",
      "account_type": null,
      "account_number": null,
      "payer_government_id": null
    },
    "cash": null,
    "pac_management": null,
    "patpass": null
  },
  "wallet_movements": []
}

🇲🇽`transaction.failed`

Transaction type en México `transaction.failed`

Transaction type 🇲🇽	Detalle
card	Pago con tarjetas
transfer	Transferencias bancarias
cash	Integración con Servipag
wallet	Movimientos de billetera digital (paypal)

Información sobre un pago fallido.

{
  "id": "wheve__ETSxl6ZF3mBkphZbIfQj5_fYAf-2FHl",
  "event_type": "transaction.failed",
  "transaction": {
    "id": "trs_PBCQK8S5t9dr8euHb5WWaa0_sOELCgoc",
    "type": "PAYMENT",
    "amount": "9450.0000",
    "currency": "MXN",
    "transaction_date": "2024-12-17 16:03:31.263605",
    "status": "FAILED",
    "transaction_metadata": {
      "enroll_card_toggle": false
    },
    "response_code": "TEKSH1008",
    "voucher": null,
    "id_checkout_session": null,
    "original_response_message": "Request Error"
  },
  "customer": {
    "id": "cus_DQZYUH734lKm2ecNl0atL6Xme37uuB_5",
    "external_id": "HEGG560427MVZRRL04",
    "email": "harrypotter@trytoku.com",
    "government_id": "HEGG560427MVZRRL04",
    "name": "Harry Potter",
    "phone_number": "+521111111111"
  },
  "payment_intents": [
    {
      "id": "pi_LawiisiJ0d5UU10ps4e8PByGMUV7jVoF",
      "amount": "9450.0000",
      "currency": "MXN",
      "id_invoice": "in_8cKh6T2lEMSmpk_rhcBP7r6KBQprfv2Q",
      "id_subscription": "sub_KX7qM_OD7U8ohrF8fpHUzu51O4iagjwi",
      "invoice_external_id": "2024-03-18 14:14:04.031199",
      "id_account": "acc_jwONBafuYIcaaQuHrRPeHJI8Gve-r-M4",
      "gateway": "payment_orchestration",
      "price_change_amount": "450.0000",
      "product_id": "example",
      "status": "FAILED",
      "type": "one_time"
    }
  ],
  "payment_instrument": {
    "type": "...",
    "card": {...},
    "transfer": {...},
    "cash": {...},
    "wallet": {...}
  },
  "wallet_movements": []
}

🇲🇽`transaction.refund`

Información sobre una devolución realizada. Incluye como información adicional (additional_data) el id de la transacción original.

{
  "id": "whe_hXPK3YBs4EUfw2KFZlB6R44MiFa07vFU",
  "event_type": "transaction.refund",
  "transaction": {
    "id": "trs_rInqjZCm4O3O48rqfEw3k9JH-R9uLLLZ",
    "type": "REVERSED",
    "amount": 5246.00,
    "currency": "MXN",
    "transaction_date": "2024-04-30 19:01:41.733489",
    "status": "SUCCESS",
    "response_code": "SUTOK0000",
    "voucher": null,
    "id_checkout_session": "cs_rInqjZCm4O3O48rqfEw3k9JH-R9uLLLZ",
    "transaction_metadata": {}
  },
  "payment_instrument": {
    "type": "...",
    "card": {...},
    "transfer": {...},
    "cash": {...},
    "wallet": {...}
  },
  "customer": {
    "id": "cus_SqTQO486U9o5LhXQjN8_saZmZsyUltoh",
    "external_id": "106056161-3520308",
    "email": "fsimmons@example.com",
    "government_id": "106056161",
    "name": "Claudio Arenas",
    "phone_number": "+56#########"
  },
  "payment_intents": [
    {
      "id": "pi_rInqjZCm4O3Or0fGqqqreOmEcl-7s7",
      "amount": 5146.00,
      "currency": "MXN",
      "id_invoice": "in_8QUrs7ozSqnX1xr0fGqqqreOmEcl-7s7",
      "id_subscription": "sub_8QUrs7ozSqnX1xr0fGqqqreOmEcl-7s7",
      "invoice_external_id": null,
      "gateway": "paycash",
      "price_change_amount": 0.00,
      "product_id": "product_id_10",
      "status": "AUTHORIZED",
      "type": "one_time"
    }
  ],
  "wallet_movements": [],
  "additional_data": {
    "transaction": {
      "id": "trs_rInqjZCm4O3O48rqfEw3k9JH-R9uLLLZ", 
      "type": "PAYMENT"
    }
  }
}

🇲🇽`transaction.bulk_success`

Información sobre pagos por lotes exitosos.

{
   "id":"wheve_f1Ubbycax6D2CR9lXmLTRAm3cGTcnFrF",
   "event_type":"transaction.bulk_success",
   "events":[
      {
         "transaction":{
            "id":"trs_lJWBAqIc7QYW443Hq_J8fZ2hl9R8kXhm",
            "type":"PAYMENT",
            "amount":"20.0000",
            "currency":"MXN",
            "transaction_date":"2024-10-10 15:16:08.593568",
            "status":"SUCCESS",
            "transaction_metadata":{...},
            "response_code":"SUTOK0000",
            "voucher":null,
            "id_checkout_session":null
         },
         "customer":{
            "id":"cus_rP88zmUc-UMnhZ26oUzoeMQKJSCoFW65",
            "external_id":"PEPJ000303MASRRNA2",
            "email":null,
            "government_id":"PEPJ000303MASRRNA2",
            "name":"PEPJ000303MASRRNA2",
            "phone_number":null
         },
         "payment_intents":[
            {
               "id":"pi_n3Y7QE5LM2weWTljMA5kbWu4FXQs1Gqa",
               "amount":"20.0000",
               "currency":"MXN",
               "id_invoice":"in_7h0OF8t5BBcJRiB3KuBpafhzS-WiScdo",
               "id_subscription":"sub_LQbXg5xdUqhtRasu2UeFrby6Kk_mKtfW",
               "invoice_external_id":"ARGOSPID3-2024-10-07",
               "id_account":"acc_tDxf4VycPU9-cokayp2M0I_wkYeBJbHG",
               "gateway":"mx_banco_scotiabank_h2h_external",
               "price_change_amount":"0.0000",
               "product_id":"ARGOSPID3",
               "status":"INITIALIZED",
               "type":"recurring"
            }
         ],
         "payment_instrument": {
            "type": "...",
            "card": {...},
            "transfer": {...},
            "cash": {...},
            "wallet": {...}
          },
         "wallet_movements":[...]
      },
      {
      	 "transaction":{
            "id":"trs_AEX7XPb6KHPED9nIsPrR8K5IhJOdynEo",
            "type":"PAYMENT",
            "amount":"21.0000",
            "currency":"MXN",
            "transaction_date":"2024-10-10 15:16:08.637128",
            "status":"SUCCESS",
            "transaction_metadata":{
               
            },
            "response_code":"SUTOK0000",
            "voucher":null,
            "id_checkout_session":null
         },
         "customer":{
            "id":"cus_caoX2Z763devjASPAwCkqPZ5vWeuP75x",
            "external_id":"PEPJ000308MASRRNA7",
            "email":null,
            "government_id":"PEPJ000308MASRRNA7",
            "name":"Patricio Pino",
            "phone_number":null
         },
         "payment_intents":[
            {
               "id":"pi_bB7OuBc0riPgjJRgGoeeRacEfNdAHEF6",
               "amount":"21.0000",
               "currency":"MXN",
               "id_invoice":"in_8nLhUkSoaeGBpujMUJ6N0RxFLHdyI75_",
               "id_subscription":"sub_fVgaHfBu-Zh7V5Of8DGGozASzXfoy7FN",
               "invoice_external_id":"ARGOSPID8-2024-10-05",
               "id_account":"acc_tDxf4VycPU9-cokayp2M0I_wkYeBJbHG",
               "gateway":"mx_banco_scotiabank_h2h_external",
               "price_change_amount":"0.0000",
               "product_id":"ARGOSPID8",
               "status":"INITIALIZED",
               "type":"recurring"
            }
         ],
         "payment_instrument":{
            "type":"account",
            "card":null,
            "transfer":null,
            "cash":null,
            "wallet":null,
            "account":{
               "account":"044180001019143859",
               "bank_id":"044",
               "bank_account_type":"40",
               "token":null,
               "status":"temporary_failed"
            }
         },
         "wallet_movements":[]
      }
   ]
}

🇲🇽`transaction.bulk_failed`

Información sobre pagos por lotes fallidos.

{
   "id":"wheve_2eHNGFQFTb2v_FGiz9UXra7K1PTJUzHW",
   "event_type":"transaction.bulk_failed",
   "events":[
      {
         "transaction":{
            "id":"trs_KLOgKsJguzpXuXnNRhoukv9fEeg7WO8x",
            "type":"PAYMENT",
            "amount":"22.0000",
            "currency":"MXN",
            "transaction_date":"2024-10-10 15:16:08.656533",
            "status":"FAILED",
            "transaction_metadata":{
               
            },
            "response_code":"UETOK9999",
            "voucher":null,
            "id_checkout_session":null
         },
         "customer":{
            "id":"cus_Sd49f8yuB-pz8XmAL810TjxnOMei-aMi",
            "external_id":"PEPJ000310MASRRNA9",
            "email":null,
            "government_id":"PEPJ000310MASRRNA9",
            "name":"Tomas Cantergiani",
            "phone_number":null
         },
         "payment_intents":[
            {
               "id":"pi_d50K5mWK7gYuLbF4Jz9mNozQ8XoDb7W8",
               "amount":"22.0000",
               "currency":"MXN",
               "id_invoice":"in_hLGdLfnABuqRIziQEm6DueD32-w5cYJB",
               "id_subscription":"sub_WUOnn14D_XAQHNcj-iWRI9mGCHzTMMC4",
               "invoice_external_id":"ARGOSPID10-2024-10-05",
               "id_account":"acc_tDxf4VycPU9-cokayp2M0I_wkYeBJbHG",
               "gateway":"mx_banco_scotiabank_h2h_external",
               "price_change_amount":"0.0000",
               "product_id":"ARGOSPID10",
               "status":"INITIALIZED",
               "type":"recurring"
            }
         ],
         "payment_instrument":{
            "type":"account",
            "card":null,
            "transfer":null,
            "cash":null,
            "wallet":null,
            "account":{
               "account":null,
               "bank_id":"40044",
               "bank_account_type":"03",
               "token":"gcd_pA7oYJW8kXs_",
               "status":"temporary_failed"
            }
         },
         "wallet_movements":[...]
      }
   ]
}

🇨🇱 Ejemplos Chile

Transaction con instrumento de pago de tipo Card

"payment_instrument": {
  "type": "card",
  "card": {
    "bin": "424242",
    "card_type": "credit",
    "card_brand": "visa",
    "country": "Chile",
    "exp_month": null,
    "exp_year": null,
    "external_id": null,
    "card_holder": "Felipe Tapia",
    "issuer": "cl_banco_santander",
    "installments_number": 1,
    "last_digits": "1234",
    "status": "chargeable",
    "token": null,
    "three_d_secure": null
  },
  "transfer": null,
  "cash": null,
  "wallet": null
}

Campos específicos

Campo	tipo	Descripción
bin	string	Primeros 6 números de la tarjeta
card_type	string	Indica si es crédito (credit), débito (debit) o prepago (prepaid)
card_brand	string	Indica la marca de la tarjeta: Visa, Mastercard o Amex son los soportados actualmente
country	string	País de emisión de la tarjeta. Si es distinto al país de la organización la transacción se considerará con tarjeta internacional.
exp_month	null	Información sensible de la tarjeta, siempre vendrá vacía
exp_year	null	Información sensible de la tarjeta, siempre vendrá vacía
card_holder	string	Nombre que ingresa el tarjetahabiente al momento de la compra
issuer	string	Nombre del emisor de la tarjeta
installments_number	int	Número de cuotas
last_digits	string	Últimos 4 dígitos de la tarjeta ingresada para la transacción. Sirve de identificador para el usuario final

Transaction con instrumento de pago de tipo Transfer

"payment_instrument": {
  "type": "transfer",
  "card": null,
  "transfer": {
    "country": "Chile",
    "institution_id": "cl_banco_santander",
    "account_type": "sight_account",
    "account_number": "1234567654",
    "payer_government_id": "183932365"
  },
 "cash": null,
  "wallet": null
}

campos específicos

Campo	tipo	Descripción
country	string	País del banco de la cuenta que se hace transferencia
institution_id	string	Identificador del banco de la cuenta que se hace transferencia
account_type	string	Indica el tipo de cuenta: corriente (checking_account), vista (sight_account) y rut (rut_account)
account_number	string	Número de cuenta que hace la transferencia
payer_government_id	string	Rut de la persona que hace la transferencia

Transaction con instrumento de pago de tipo PAC

"payment_instrument": {
  "type": "pac_management",
  "card": null,
  "transfer": null,
  "cash": null,
  "pac_management": {
    "country": "Chile",
    "mandate_id": "OI288287",
    "institution_id": "cl_banco_de_chile",
    "payer_name": "Sofia Gallardo",
    "payer_government_id": "135551236",
    "sbif": "001"
}

campos específicos

Campo	tipo	Descripción
country	string	País del banco de la cuenta que se hace transferencia
mandate_id	string	Identificador del Mandato, lo que sirve para cobrar directamente en la nómina del banco.
institution_id	string	Identificador del banco de la cuenta que se hace transferencia
account_type	string	Indica el tipo de cuenta: corriente (checking_account), vista (sight_account) y rut (rut_account)
payer_government_id	string	Rut de la persona que hace la transferencia

Transaction con instrumento de pago de tipo PatPass

🇲🇽 Ejemplos México

Transaction con instrumento de pago de tipo Card

"payment_instrument": {
  "type": "card",
  "card": {
    "bin": "424242",
    "card_type": "credit",
    "card_brand": "visa",
    "country": "Mexico",
    "exp_month": null,
    "exp_year": null,
    "external_id": null,
    "card_holder": "Claudio Arenas",
    "issuer": "banco_santander",
    "installments_number": 1,
    "last_digits": "4242",
    "status": "chargeable",
    "token": null,
    "three_d_secure": null
  },
  "transfer": null,
  "cash": null,
  "wallet": null
}

Campos específicos

Campo	tipo	Descripción
bin	string	Primeros 6 números de la tarjeta
card_type	string	Indica si es crédito (credit), débito (debit) o prepago (prepaid)
card_brand	string	Indica la marca de la tarjeta: Visa, Mastercard, Amex, etc.
country	string	País de emisión de la tarjeta. Si es distinto al país de la organización la transacción se considerará con tarjeta internacional.
exp_month	null	Información sensible de la tarjeta, siempre vendrá vacía
exp_year	null	Información sensible de la tarjeta, siempre vendrá vacía
card_holder	string	Nombre que ingresa el tarjetahabiente al momento de la compra
issuer	string	Nombre del emisor de la tarjeta
installments_number	int	Número de cuotas
last_digits	string	Últimos 4 dígitos de la tarjeta ingresada para la transacción. Sirve de identificador para el usuario final

Transaction con instrumento de pago de tipo Transfer

"payment_instrument": {
  "type": "transfer",
  "card": null,
  "transfer": {
    "beneficiary_clabe": "646000000000000001",
    "payer_name": "Claudio Arenas",
    "payer_clabe": "646000000000000023",
    "tracking_id": "dj8329djf8",
    "transaction_date": "2024-04-30T19:01:41.733489"
  },
  "cash": null,
  "wallet": null
}

campos específicos

Campo	tipo	Descripción
beneficiary_clabe	string	Cuenta CLABE que recibe de la transferencia
payer_name	string	Nombre del pagador
payer_clabe	string	Cuenta CLABE que emite la transferencia
tracking_id	string	Identificador que permite hacer un tracking correcto
transaction_date	string	Fecha y hora de la transacción

Transaction con instrumento de pago de tipo Cash

"payment_instrument": {
  "type": "cash",
  "card": null,
  "transfer": null,
  "cash": {
    "auth_code": null,
    "barcode_url": "https://www.barcode.com/dasuhdiau",
    "expiration_date": null,
    "reference": "d0duas0",
    "store_name": null,
    "is_recurrent": true
  },
  "wallet": null
}

Transaction con instrumento de pago de tipo Wallet

"payment_instrument": {
  "type": "cash",
  "card": null,
  "transfer": null,
  "cash": null,
  "wallet": {
    "company": "Paypal"
  }
}

transaction.success

Transaction type soportados en Chile para transaction.success

Transaction type soportados en México transaction.success

Información sobre un pago exitoso.

🇨🇱transaction.failed

Transaction type sportados en Chile para transaction.failed

🚧Para el caso de las transacciones type: card, pac_management y cash se está trabajando en implementar este webhook

🇲🇽transaction.failed

Transaction type en México transaction.failed

🇲🇽transaction.refund

🇲🇽transaction.bulk_success

🇲🇽transaction.bulk_failed

🇨🇱 Ejemplos Chile

Transaction con instrumento de pago de tipo Card

Campos específicos

Transaction con instrumento de pago de tipo Transfer

campos específicos

Transaction con instrumento de pago de tipo PAC

campos específicos

Transaction con instrumento de pago de tipo PatPass

🇲🇽 Ejemplos México

Transaction con instrumento de pago de tipo Card

Campos específicos

Transaction con instrumento de pago de tipo Transfer

campos específicos

Transaction con instrumento de pago de tipo Cash

Transaction con instrumento de pago de tipo Wallet

`transaction.success`

Transaction type soportados en Chile para `transaction.success`

Transaction type soportados en México `transaction.success`

🇨🇱`transaction.failed`

Transaction type sportados en Chile para `transaction.failed`

🚧
Para el caso de las transacciones type: card, pac_management y cash se está trabajando en implementar este webhook

🇲🇽`transaction.failed`

Transaction type en México `transaction.failed`

🇲🇽`transaction.refund`

🇲🇽`transaction.bulk_success`

🇲🇽`transaction.bulk_failed`