API Reference

Eventos de Webhook

Información sobre las inscripciones realizados por Toku. El campo type en payment_method indica el método de pago inscrito. La información del método de pago se encontrará en el campo con nombre igual al valor de type en payment_method.

payment_method.attached_products

Se ha inscrito un medio de pago en la plataforma y envía una lista de los productos asociados.

{
    "id": "wheve_FIfAF967KO1Azk9SKyXTibQWSW9awjUt",
    "event_type": "payment_method.attached_products",
    "payment_method": {
        "created_at": "2025-06-16 20:02:45.377877",
        "id": "pm_YVI-VQvUXdVv82XDhp7PHMSCaqUl-1Uu",
        "type": "card",
        "card": {
            ...
        },
        "bank_account": null,
        "pix": null,
        "status": "chargeable",
        "external_id": "example_external_id",
        "payment_method_metadata": {...}
    },
    "customer": {
        "id": "cus_example",
        "external_id": "example_external_od",
        "email": "[email protected]",
        "government_id": null,
        "name": "Jon Doe",
        "phone_number": "+521111111111"
    },
    "gateway": "example_gateway",
    "product_ids": [
        "example_product_id"
    ],
    "subscription_ids": [
        "sub_example_sub"
    ],
    "id_checkout_session": "cs_example_cs",
    "id_account": "acc_example_acc"
}

payment_method.attached_products CARD

{
    "id": "wheve_FIfAF967KO1Azk9SKyXTibQWSW9awjUt",
    "event_type": "payment_method.attached_products",
    "payment_method": {
        "created_at": "2025-06-16 20:02:45.377877",
        "id": "pm_YVI-VQvUXdVv82XDhp7PHMSCaqUl-1Uu",
        "type": "card",
        "card": {
            "institution_country": "MX",
            "bank_id": null,
            "bank_name": "demo_bank",
            "additional_data": null,
            "bin": "424242",
            "card_type": "credit",
            "card_brand": "MASTERCARD",
            "expiration_month": "03",
            "expiration_year": "2028",
            "card_holder": "jon doe",
            "last_digits": "4242",
            "token": null,
            "three_d_secure": false
        },
        "bank_account": null,
        "pix": null,
        "status": "chargeable",
        "external_id": "example_external_id",
        "payment_method_metadata": {...}
    },
    "customer": {
        "id": "cus_example",
        "external_id": "example_external_id",
        "email": "[email protected]",
        "government_id": null,
        "name": "Jon Doe",
        "phone_number": "+521111111111"
    },
    "gateway": "example_gateway",
    "product_ids": [
        "example_product_id"
    ],
    "subscription_ids": [
        "sub_example_sub"
    ],
    "id_checkout_session": "cs_example_cs",
    "id_account": "acc_example_acc"
}

payment_method.attached_products🇨🇱 PAC

{
 "id": "wheve_aeB5CERoAiZDk2sX45XWPn5tSWEslXLD",
 "event_type": "payment_method.attached_products",
 "payment_method": {
          "id": "pm_nrpia12RsIb0M3MfBxsUrVNPiI_VDYc",
          "customer": "cus_mwKfdsXx9ssrPBTNs3E8ZqRx5Y0CSJUIc",
          "gateway": "toku_pac",
          "card_type": null,
          "card_number": null,
          "status": "chargeable",
          "additional": {
            "holder_id": "12685838-5",
            "account_type": "checking_account",
            "account_number": "00002188122",
            "institution_id": "cl_banco_estado",
            "institution_name": "Banco Estado",
            "institution_country": "cl",
            "limit_uf": 500,
            "mandate_id": null,
            "voucher_url": null,
            "voucher": null
          },
          "product_ids": [
            "SuscripcionProducto-2354"
          ],
          "id_account": "acc_K-Bzvdo9Di171WKzxBu3BNmc2j561c"
        }

payment_method_inscription_intent.failed

Intento de inscripción de un medio de pago fallido.

{
  "id": "whe_hXPK3YBs4EUfw2KFZlB6R44MiFa07vFU",
  "event_type": "payment_method_inscription_intent.failed",
  "payment_method_inscription_intent": {
    "id_payment_method_inscription_intent": "pmii_dfs54g5sr4dv5sf",
    "id_payment_method": "pm_dfs54g5sr4dv5sf",
    "external_id": "pm_dfs54g5sr4dv5sf",
    "customer": "cus_dfs54g5sr4dv5sf",
    "gateway": "dummy_gateway",
    "status": "failed",
    "toku_response_code": "123",
    "additional": {
      "holder_id": "161108284",
      "account_type": "checking_account",
      "account_number": "0087321370",
      "institution_id": "cl_banco_bci",
      "institution_name": "Banco BCI",
      "institution_country": "cl",
      "limit_uf": 10,
      "mandate_id": "19042794K",
      "voucher_url": "https://storage.googleapis.com/pac-vouchers-prod/1a8e3c6ae7d49e/dummy/pm_dummy12313.png"
    },
    "id_account": "acc_2YPKc-NZPwxBYf6hnLsstaqG9JAZKxX4"
  }
}

🇲🇽 bank_account_verification.result

Respuesta de la validación de una cuenta. Notifica la información que se obtuvo producto de una validación.

{
    "id": "whe_hXPK3YBs4EUfw2KFZlB6R44MiFa07vFU",
    "event_type": "bank_account_verification.result",
    "bank_account_verification": {
        "id_bank_account_verification": null,
        "status": "DONE",
        "validation": "failed",
        "reason": null,
        "voucher_url": {
            "pdf": "https://storage.googleapis.com/domiciliation-validation/bav_rNaGT3DOzVYgfU9TpFLZ9CNjEx9Jtest.B.pdf",
            "xml": "https://storage.googleapis.com/domiciliation-validation/bav_rNaGT3DOzVYgfU9TpFLZ9CNjEx9Jtest.B.xml",
        },
        "account_number": "111111111111111111",
        "customer_identifier": "111111111111",
        "customer_name": "Nombre enviado",
        "voucher_information": {
            "account_number": "111111111111111111",
            "customer_identifier": "1111111111111",
            "receiver_institution": "BANORTE",
            "receiver_name": "TEST TEST",
            "receiver_account_type": "40",
            "operation_date": "2022-10-14",
            "operation_time": "14:41:31",
            "spei_id": "11111",
            "signature": "mYfEz2/nPaTmKjG1LsVcXsFg/QoDpWYb0qoB4dULelSYCfNzI8iU6RkH7JhATvx9+3aP5tKjG1LsVcXsFg/QoDpWYb0qoB4dULel\n    SYCfNzI8iU6RkH7JhATvx9+3aP5tFzLb9/eDUGhQorY6nTEbxyZwca8sGVKQ2aLqpEuRSsLsVcXsFg/QoDpWYb0qoB4dULelSYCfNzI8iU6RkH7JhATv\n    x9+3aP5tKjG1LsVcXsFg/QoDpWYb0qoB4dULelSYCfNzI8iU6RkH7JhATvx9+3aP5tFzLb9/eDUGhQorY6nTEbxyZvhitQ==",
            "certificate_number": "00001000000501111111",
            "cda_chain": "||1|14102022|14102022|144131|11111|STP|TESTING S DE RL DE CV|40|111111111111111111|TEST220304U60\n    |BANORTE|TEST TEST|40|111111111111111111|1111111111111|Validation transfer|0.00|0.01|NA|NA|0|0|NA|0\n    |0.00|00001000000501732145||mYfEz2/nPaTmKjG1LsVcXsFg/QoDpWYb0qoB4dULelSYCfNzI8iU6RkH7JhATvx9+3aP5tKjG1LsVcXsFg/QoDpWYb0qoB4dULel\n    SYCfNzI8iU6RkH7JhATvx9+3aP5tFzLb9/eDUGhQorY6nTEbxyZwca8sGVKQ2aLqpEuRSsLsVcXsFg/QoDpWYb0qoB4dULelSYCfNzI8iU6RkH7JhATv\n    x9+3aP5tKjG1LsVcXsFg/QoDpWYb0qoB4dULelSYCfNzI8iU6RkH7JhATvx9+3aP5tFzLb9/eDUGhQorY6nTEbxyZvhitQ==",
            "tracking_id": "2022101411111BNRT1939536CAMTT",
        },
        "customer_data_validation": {
            "receiver_name_match_result": true,
            "receiver_name_match_score": 85,
            "rfc_match_result": false,
            "rfc_match_score": 75,
        },
    },
}

🇨🇱 Ejemplos Chile

Los campos institution_name e institution_id pueden tomar los siguientes valores:

institution_nameinstitution_id
Banco BCIcl_banco_bci
Banco de Chilecl_banco_de_chile
Banco Estadocl_banco_estado
Banco Falabellacl_banco_falabella
Banco Itaúcl_banco_itau
Banco Santandercl_banco_santander
Banco Scotiabankcl_banco_scotiabank

payment_method.attached_products 🇨🇱 Transbank

{  
  "id": "eve_NFMjlWEFasu7MTBm_bAFUz9ZmD5Cm1Pw",  
  "event_type": "payment_method.attached_products",  
  "payment_method": {  
    "id": "pm_dfs54g5sr4dv5sf",  
    "customer": "cus_dfs54g5sr4dv5sf",  
    "gateway": "transbank_oneclick",  
    "card_type": "credit",  
    "card_number": "XXXXXXXXX1234",  
    "status": "chargeable",  
    "additional": {
      "holder_id": null,
      "account_type": null,
      "account_number": null,
      "institution_id": null,
      "institution_name": null,
      "institution_country": null,
      "limit_uf": null,
      "mandate_id": null,
      "voucher_url": null,
      "voucher": null
    }, 
    "product_ids": ["product-id-1"]  ,
    "id_account": "acc_2YPKc-NZPwxBYf6hnLsstaqG9JAZKxX4"
  }  
}

payment_method.attached_products Cards PSP - Klap

Cuerpo por defecto

{
 "id": "wheve_fLN_E0szi-Vmjs-o_G011z4SSuTHsP8m",
 "event_type": "payment_method.attached_products",
 "payment_method": {
          "id": "pm_63ZOp_FNUd5X_eIasyJlVEZ3TrHMXAg",
          "customer": "cus_pB5I-nPcd8KEWBOlQdd0WUaW893nDlm",
          "gateway": "internal_psp",
          "card_type": "credit",
          "card_number": "XXXXXXXXXXXX7987",
          "status": "chargeable",
          "additional": {
            "holder_id": null,
            "account_type": null,
            "account_number": null,
            "institution_id": null,
            "institution_name": null,
            "institution_country": null,
            "limit_uf": null,
            "mandate_id": null,
            "voucher_url": null,
            "voucher": null
          },
          "product_ids": [
            "SuscripcionProducto-1234"
          ],
          "id_account": "acc_ouI4ex1Ou2hSKAsmMeUff-GT2ie3_uRQ"
 }
}

En caso que se requiera información adicional sobre la tarjeta (como bin, marca, nombre del tarjetahabiente e información de la institución) se debe solicitar una configuración extra para su organización. La estructura asociada es como la que sigue:

{
 "id": "wheve_fLN_E0szi-Vmjs-o_G011z4SSuTHsP8m",
 "event_type": "payment_method.attached_products",
 "payment_method": {
          "id": "pm_63ZOp_FNUd5X_eIasyJlVEZ3TrHMXAg",
          "customer": "cus_pB5I-nPcd8KEWBOlQdd0WUaW893nDlm",
          "gateway": "internal_psp",
          "card_type": "credit",
          "card_number": "XXXXXXXXXXXX7987",
          "status": "chargeable",
          "additional": {
            "holder_id": null,
            "account_type": null,
            "account_number": null,
            "institution_id": null,
            "institution_name": "cl_banco_estado",
            "institution_country": "cl",
            "limit_uf": null,
            "mandate_id": null,
            "voucher_url": null,
            "voucher": null,
            "cardholder_name": "John Doe",
            "card_bin": "566777",
            "card_brand": "VISA"
          },
          "product_ids": [
            "SuscripcionProducto-1234"
          ],
          "id_account": "acc_ouI4ex1Ou2hSKAsmMeUff-GT2ie3_uRQ"
 }
}

payment_method.attached_products🇨🇱 PAC

{
 "id": "wheve_aeB5CERoAiZDk2sX45XWPn5tSWEslXLD",
 "event_type": "payment_method.attached_products",
 "payment_method": {
          "id": "pm_nrpia12RsIb0M3MfBxsUrVNPiI_VDYc",
          "customer": "cus_mwKfdsXx9ssrPBTNs3E8ZqRx5Y0CSJUIc",
          "gateway": "toku_pac",
          "card_type": null,
          "card_number": null,
          "status": "chargeable",
          "additional": {
            "holder_id": "12685838-5",
            "account_type": "checking_account",
            "account_number": "00002188122",
            "institution_id": "cl_banco_estado",
            "institution_name": "Banco Estado",
            "institution_country": "cl",
            "limit_uf": 500,
            "mandate_id": null,
            "voucher_url": null,
            "voucher": null
          },
          "product_ids": [
            "SuscripcionProducto-2354"
          ],
          "id_account": "acc_K-Bzvdo9Di171WKzxBu3BNmc2j561c"
        }

🇲🇽 Ejemplos México

payment_method.attached_products cuando el PaymentMethod es de tipo Card

{  
	"bin": "456745",
  "card_type": "DEBIT",  
	"card_brand": "VISA",
	"institution_country": "MX",
	"created_at": "2022-04-07 21:39:28.344703",
  "expiration_month": "8",
  "expiration_year": "2024",
  "card_holder": "Dante Loyola", 
	"last_digits": "4242",
	"token": "abc_1234",
	"three_d_secure": false,
	"bank_id": "90002",
	"institution_id": "mx_banco_santander", 
	"bank_name": "Banco Santander",
	"additional_data": {},
	"three_d_secure": false
}

payment_method.attached_products cuando el PaymentMethod es de tipo BankAccount

{
		"institution_country": "MX",
    "bank_id": "90002",
    "bank_name": "Banco Santander",
    "additional_data": {},
		"account_number": "004420158600",
		"account_type": "bank_account", // bank_account / debit
		"name": "Rodrigo Rodriguez Palma"
}