Payouts: México

Algunas particularidades sobre los payouts en México:

Datos solicitados del origen de un payout

Para máxima compatibilidad con distintos bancos e instituciones financieras, usa el identificador CLABE de la cuenta bancaria desde la que se envía dinero:

{
  "name": "Empresa ABC",
  "identification": {
    "id_schema": "MXRFC",
    "id": "EABC800101XXX"
  },
  "account": "012180000118901234",
  "account_type": "clabe",
  "email": "[email protected]"
}

Datos solicitados del destinatario de un payout

En México los datos solicitados dependen del destino de una transferencia: intrabancaria, interbancaria usando CLABE o a tarjeta de débito.

Datos solicitados para payouts interbancarios con CLABE

• Nombre: El nombre del destinatario del pago. Ej: "Juan Perez". Este dato no es verificado ni por Shinkansen, ni por la institución financiera de origen ni por la institución financiera de destino.
• RFC o CURP: El RFC o CURP del destinatario del pago. Ej: "JUPR800101XXX". Aunque es opcional en la mayoría de los bancos, si en tus sistemas cuentas con la informacion es mejor incluirlo (por ejemplo: para que puedas contar con esta información en la reportería y dashboard de Shinkansen).

🤷‍♂️

Si no tienes el RFC o el CURP, deberás usar el string"NA" en el campo creditor.identification.id.

• CLABE: La CLABE del destinatario del pago. "012180000118901234". ¿Qué es la CLABE?
• Correo electrónico: El correo electrónico del destinatario del pago, para el envío de comprobantes. Ej: "[email protected]".

Estos datos se mapean al creditor de un mensaje de payout de la siguiente forma:

{
  "name": "Juan Perez",
  "identification": {
    "id_schema": "MXRFC",
    "id": "JUPR800101XXX"
  },
  "account": "012180000118901234",
  "account_type": "clabe",
  "email": "[email protected]"
}

{
  "name": "Juan Perez",
  "identification": {
    "id_schema": "MXRFC",
    "id": "NA"
  },
  "account": "012180000118901234",
  "account_type": "clabe",
  "email": "[email protected]"
}

Datos solicitados para payouts interbancarios a tarjeta de débito

• Nombre: El nombre del destinatario del pago. Ej: "Juan Pérez". Este dato no es verificado ni por Shinkansen, ni por la institución financiera de origen ni por la institución financiera de destino.
• RFC: El RFC del destinatario del pago. Ej: "JUPR800101XXX". También es posible agregar el valor especial "NA".
  • El RFC o CURP del destinatario no son estrictamente necesarios para realizar la transferencia. No obstante, se recomienda incorporarlo.
  • El valor especial "NA" puede ser asignado al RFC o CURP del destinatario del pago, si es que no se cuenta con el valor de ese dato.
• Número de TDD: El número de tarjeta. Ej: "1234567890123456".
• Banco: El banco emisor de la tarjeta. Ej: "BANAMEX".
• Correo electrónico: El correo electrónico del destinatario del pago, para el envío de comprobantes. Ej: "[email protected]".

Estos datos se mapean al creditor de un mensaje de payout de la siguiente forma:

{
  "name": "Juan Parez",
  "identification": {
    "id_schema": "MXRFC",
    "id": "JUPR800101XXX"
  },
  "financial_institution": {
    "fin_id_schema": "SHINKANSEN",
    "fin_id": "BANAMEX_MX"
  },
  "account": "1234567890123456",
  "account_type": "debit_card",
  "email": "[email protected]"
}

Datos solicitados para payouts intrabancarios

Si el destinatario tiene cuenta en el mismo banco desde donde se origina el payout, se puede solicitar el número de cuenta directamente. En este caso los datos necesarios son:

• Nombre: El nombre completo del destinatario del pago. Ej: "Juan Pérez".
• RFC: El RFC del destinatario del pago. Ej: "JUPR800101XXX". También es posible agregar el valor especial "NA".
• Número de cuenta: El número de cuenta. Ej: "1234567890".
• Tipo de cuenta: El tipo de cuenta. Ej: "Cuenta corriente".
• Banco: El banco de la cuenta. Ej: "BBVA Bancomer".
• Correo electrónico: El correo electrónico del destinatario del pago, para el envío de comprobantes. Ej: "[email protected]".

Estos datos se mapean al creditor de un mensaje de payout de la siguiente forma:

{
  "name": "Juan Parez",
  "identification": {
    "id_schema": "MXRFC",
    "id": "JUPR800101XXX"
  },
  "financial_institution": {
    "fin_id_schema": "SHINKANSEN",
    "fin_id": "BBVA_BANCOMER_MX"
  },
  "account": "1234567890",
  "account_type": "current_account",
  "email": "[email protected]"
}

Esto sólo funcionará si la financial_institution del debtor es exactamente el mismo banco que el financial_institution del creditor.

Más información

En la página de códigos más usados puedes ver mas información sobre los códigos de instituciones financieras, tipos de cuenta y esquemas de identificación.

Incluir el número de referencia, la clave de rastreo y el concepto de pago.

El concepto de pago corresponde al campo description del payout.
El número de referencia y la clave de rastreo, pueden ser utilizados como valores para tener trazabilidad sobre el payout. Son opcionales y si no son asignados al momento de enviar el payout por parte del participante, Shinkansen les asigna valores a ambos campos.

reference_number: Es una referencia numérica asociada al pago. Puede tomar un valor entero positivo de hasta 7 dígitos. Se recibe como un string.
tracking_key: Clave de rastreo asociada a la orden de pago. Debe ser única por operación y por día. La longitud mínima debe ser de 8 caracteres. Dentro de la Clave de rastreo no se reconocerá ningún tipo de carácter especial (no se permiten símbolos, ni espacios, ni tampoco acentos), sólo acepta letras del alfabeto y los números 0 al 9 y es la clave de identificación estándar reconocida por Banco de México

{
  "transaction_type": "payout",
  "description": "Pago Orden 12398",
  "reference_number": "12398",
	"tracking_key": "FINID9998832342ZUIO9234jkl"
  ...
}

STP permite la asignación de ambos campos, reference_number y tracking key.
BBVA solo permite asignar el reference_number

Bancos utilizados

El API de Shinkansen permite realizar payouts automáticos desde tu cuenta en BBVA o desde tu cuenta en STP. Si necesitas soporte para otro banco donde ya tengas cuenta abierta y no esté soportado como origen de payouts en Shinkansen, contáctanos.

Caso especial: transferencia sin fondos desde STP Una de las particularidades de hacer payouts automáticos a través de STP es que si realizas un pago y no tienes fondos, la transacción será encolada por STP y será ejecutada apenas abones fondos a la cuenta. En el intertanto la transacción tendrá el status de pending y no podrá ser cancelada.

Horarios de transferencias

SPEI

Cuando tu cuenta de origen está en STP, hay dos horarios relevantes:

• Si tienes contratado el servicio 24/7, podrás enviar transacciones 24/7 😃
• Si no lo tienes contratado, podrás enviar transferencias los días hábiles entre 6:00 y 23:00.

Cuando tu cuenta de origen está en BBVA, también tienes dos horarios relevantes según si tienes activado el servicio API o el servicio Host to Host (Contáctanos si tienes dudas sobre cuál servicio es mejor para ti):

• H2H: días hábiles de 6:00 a 16:30 cuando tu pago es a otro banco y entre 6:00 y 20:30 cuando es a BBVA.
• API: 24/7

CECOBAN (pago de nóminas)

Si tu cuenta de origen está en BBVA y quieres pagar una nómina a una cuenta que también está en BBVA, estos son los horarios relevantes:

Cuenta destino BBVA

Si tu cuenta de origen está en BBVA y quieres pagar una nómina interbancaria, estos son los horarios relevantes:

Cuenta destino cualquier banco

*Considera días hábiles de lunes a viernes.

El pago de nóminas se encuentra activo para cuentas de destino en las siguientes instituciones financieras:

Limites

Operador: STP_MX

No hay límites por operación.

Operador: BBVA_MEXICO_MX

Estos límites referenciales aplican típicamente a los payouts operados a través del Banco BBVA México:

• Máximo por transacción interbancaria o intrabancaria a través de H2H: Sin restricción
• Máximo por transacción interbancaria a través de API: Sin restricción de lunes a viernes de 6:00 am a 5:30 pm, fuera de este horario el máximo es de 3.000.000 (tres millones de pesos).
• Máximo por transacción intrabancaria a través de API: Sin restricción
• Máximo diario por destinatario: N/A
• Máximo diario por cuenta de origen: N/A