Payin Notifications en 🇲🇽 México
Detalles específicos de Payin Notifications en México
Notificaciones de pagos entrantes
En México existe un identificador único de cuentas bancarias denominado CLABE. En la práctica, la CLABE es toda la información que requieres para hacer una transferencia bancaria.
Dado lo anterior, a la hora de recibir pagos, es posible que no cuentes con información del Debtor/Originador de la transacción.
Para poder conciliar la notificación recibida por Shinkansen, puedes tú mismo asignar el pago entrante de acuerdo a las características de la transacción como el monto y la hora de recepción.
Una alternativa que resulta muy útil en México es tener tantas cuentas como clientes tengas. ¿Para qué? Para asignar un número de cuenta distinto a cada uno de tus clientes, de manera que, al recibir un pago, puedas identificar quién es el originador de dicha transacción.
Notificaciones en STP
| Shinkansen | Equivalente en STP | Descripción | Obligatorio |
|---|---|---|---|
notification_id | NA | Identificador único de la notificación generado por Shinkansen | ✅ |
shinkansen_notification_id | NA | Identificador único de la notificación generado por Shinkansen | ✅ |
original_notification_id | NA | Identificador único de la notificación generado por Shinkansen | ✅ |
notification_date | NA | Fecha y hora de la creación de la notificación | ✅ |
transaction_date | tsLiquidacion | Timestamp en milisegundos de la liquidación convertido a datetime UTC | ✅ |
transaction_accounting_date | fechaOperacion | Fecha de operación en formato AAAAMMDD convertido a datetime UTC | ✅ |
notification_type | NA | Tipo de notificación ("payin") | ✅ |
currency | NA | Moneda de la transacción ("MXN") | ✅ |
amount | monto | Monto de la orden de pago | ✅ |
description | conceptoPago | Concepto asociado al pago | ✅ |
debtor.name | nombreOrdenante | Nombre del ordenante | ❌ |
debtor.identification.id_schema | NA | Esquema de identificación (ver https://docs.shinkansen.tech/docs/tipos-de-identificacion#mexico-) | ✅ |
debtor.identification.id | rfcCurpOrdenante | RFC o CURP del ordenante | ❌ |
debtor.financial_institution.fin_id_schema | NA | Siempre "Shinkansen" | ✅ |
debtor.financial_institution.fin_id | institucionOrdenante | Institución financiera ordenante (ver https://docs.shinkansen.tech/docs/instituciones-financieras#m%C3%A9xico-) | ✅ |
debtor.account_type | tipoCuentaOrdenante | Tipo de cuenta del ordenante (ver https://docs.shinkansen.tech/docs/tipos-de-cuentas#m%C3%A9xico-) | ❌ |
debtor.account | cuentaOrdenante | Cuenta del ordenante | ❌ |
creditor.name | NA | Nombre del beneficiario | ✅ |
creditor.identification.id_schema | NA | Esquema de identificación (ver https://docs.shinkansen.tech/docs/tipos-de-identificacion#mexico-) | ✅ |
creditor.identification.id | rfcCurpBeneficiario | RFC o CURP del beneficiario | ❌ |
creditor.financial_institution.fin_id_schema | NA | Siempre "Shinkansen" | ✅ |
creditor.financial_institution.fin_id | institucionBeneficiaria | Institución financiera beneficiaria (ver https://docs.shinkansen.tech/docs/instituciones-financieras#m%C3%A9xico-) | ✅ |
creditor.account_type | tipoCuentaBeneficiario | Tipo de cuenta del beneficiario (ver https://docs.shinkansen.tech/docs/tipos-de-cuentas#m%C3%A9xico-) | ✅ |
creditor.account | cuentaBeneficiario | Cuenta del beneficiario | ✅ |
payment_operator_metadata.claveRastreo | claveRastreo | Clave única de rastreo del pago | ✅ |
payment_operator_metadata.referenciaNumerica | referenciaNumerica | Referencia numérica del pago | ✅ |
payment_operator_metadata.tsLiquidacion | tsLiquidacion | Timestamp en milisegundos de la liquidación | ✅ |
payment_operator_metadata.folioCodi | folioCodi | Folio de mensaje CODI no presencial | ❌ |
referenced_shinkansen_notification_ids | NA | Lista de IDs de notificaciones relacionadas | ❌ |
¿Cómo abrir múltiples cuentas CLABE?
En Shinkansen te ayudamos a abrir cuenta en STP, una institución financiera regulada en México bajo la figura de las IFPE.
En dicho proceso te entregamos una Cuenta CLABE de 18 dígitos con la siguiente estructura:
646-180-XXXXXX-YYYYY-Z
- Primeros 3 dígitos: identifican a la institución STP y equivalen a 646
- Siguientes 3 dígitos: identifican la “plaza” o lugar donde opera STP, en este caso Ciudad de México, y equivalen a 180.
- Siguientes 6 dígitos (XXXXXX): identifican al cliente de Shinkansen. Nosotros te lo entregaremos.
- Siguientes 5 dígitos (YYYYY): los puedes ocupar libremente. Con esto tendrás una cuenta “padre” (aquella que resulta de tener 5 dígitos iguales a “0”) y 99.999 otras combinaciones posibles de sub-cuentas que podras asignar a cada uno de tus clientes o pagadores. No debes hacer nada para activarlas.
- Último dígito (Z): dígito verificador. Es entregado por Shinkansen o lo puedes calcular tú mismo más abajo.
Con esta estructura, más nuestro mensaje de notificación enviado a tu webhook, podrás determinar en pocos segundos quién es el originador del pago que recibiste.
¿Cómo calcular el dígito verificador?
Ingresa los primeros 17 dígitos de tu cuenta CLABE en esta planilla y obtén tu dígito verificador.
Updated 23 days ago