Tarjeta de crédito

Procesa pagos con tarjeta de crédito o débito directamente desde tu integración. Puedes cobrar con los datos de la tarjeta o usando un token generado previamente.

Crear pago con tarjeta

Método: POST Endpoint: /Api/v2/cobros/pago_tarjeta_ecomerce Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "amount": "1.00",
  "save_card": false,
  "card": {
    "card_number": "4242424242424242",
    "sec_code": "791",
    "exp_month": "06",
    "exp_year": "31",
    "cardholder_name": "Juan Pérez"
  },
  "client": {
    "num_cel": "5555555555",
    "first_name": "Juan",
    "paternal_surname": "Pérez",
    "maternal_surname": "García",
    "concept": "Pago de servicio"
  }
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`amount`	string	Sí	Monto a cobrar
`save_card`	boolean	No	Indica si la tarjeta se tokeniza para cobros futuros. Por defecto `false`
`card.card_number`	string	Sí	Número de tarjeta
`card.sec_code`	string	Sí	Código de seguridad
`card.exp_month`	string	Sí	Mes de expiración
`card.exp_year`	string	Sí	Año de expiración
`card.cardholder_name`	string	Sí	Nombre del titular de la tarjeta
`client.num_cel`	string	No	Teléfono del cliente
`client.first_name`	string	Sí	Nombre del cliente
`client.paternal_surname`	string	Sí	Apellido paterno del cliente
`client.maternal_surname`	string	No	Apellido materno del cliente
`client.concept`	string	No	Descripción del cobro

El campo token_card aparece en la respuesta únicamente cuando save_card es true. Guarda ese valor para usarlo en cobros futuros sin que el cliente tenga que ingresar sus datos de tarjeta nuevamente.

Así se ve para tu cliente

Si usas el checkout hospedado de PayCode (Payment Link o Checkout Elements) en lugar de construir tu propio formulario, esto es lo que tu cliente ve al elegir pagar con tarjeta. Cada campo corresponde a uno de los campos que se describieron arriba:

Campo visible	Campo en el request
Nombre en la tarjeta	`card.cardholder_name`
Número de tarjeta	`card.card_number`
Fecha de vencimiento	`card.exp_month` / `card.exp_year`
CVV	`card.sec_code`

Card — Formulario de captura de tarjeta que ve el cliente al elegir pagar con tarjeta en el checkout hospedado de PayCode.

Si integras directamente contra este endpoint (Full API) en lugar de usar el checkout hospedado, tú construyes tu propio formulario, esta captura es solo de referencia para saber qué información necesitas capturar.

Crear pago con token

Procesa un cobro usando un token generado previamente con save_card: true. Método: POST Endpoint: /Api/v2/cobros/pago_token_ecomerce Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "amount": "1.00",
  "token_card": "VvKzS4Ay1Adp2-v4BczhkS2Q8EAktQFCRLrk5VCN2fU%3D"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`amount`	string	Sí	Monto a cobrar
`token_card`	string	Sí	Token obtenido al realizar un pago con `save_card: true`

Obtener transacciones

Consulta el historial de transacciones procesadas con tarjeta. Método: GET Endpoint: /Api/v2/transacciones/obtener_transacciones Header requerido: Authorization: Bearer {token}

Este endpoint tiene un límite de 120 peticiones por minuto. Consulta la sección Autenticación y seguridad para más información sobre rate limiting.

Cancelar transacción

Cancela una transacción procesada con tarjeta usando su track_code. Método: POST Endpoint: /Api/v2/cobros/void_tarjeta_ecomerce Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "track_code": "00000000"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`track_code`	string	Sí	Identificador de la transacción a cancelar

Obtener estatus de transacción

Consulta el estatus actual de una o varias transacciones. Método: POST Endpoint: /Api/v2/transacciones/obtener_estatus_transacciones Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "transactions": [
    "177931493769"
  ]
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`transactions`	array	Sí	Lista de identificadores de transacciones a consultar

Puedes consultar el estatus de múltiples transacciones en una sola llamada enviando más de un identificador dentro del array transactions.

Banregio

Los siguientes endpoints aplican exclusivamente para transacciones procesadas a través de Banregio.

Venta

Método: POST Endpoint: /Api/v2/banregio/sale Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "amount": 300,
  "card": "4456530000001096",
  "exp": "1224",
  "code": "123"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`amount`	integer	Sí	Monto a cobrar
`card`	string	Sí	Número de tarjeta
`exp`	string	Sí	Fecha de expiración en formato `MMYY`
`code`	string	Sí	Código de seguridad

Venta en meses sin intereses

Método: POST Endpoint: /Api/v2/banregio/sale-msi Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "amount": 200,
  "card": "4456530000001096",
  "exp": "1224",
  "code": "123",
  "promo_diff": "00",
  "msi": "06",
  "plan_promo": "03"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`amount`	integer	Sí	Monto a cobrar
`card`	string	Sí	Número de tarjeta
`exp`	string	Sí	Fecha de expiración en formato `MMYY`
`code`	string	Sí	Código de seguridad
`promo_diff`	string	Sí	Código de diferimiento de la promoción
`msi`	string	Sí	Número de meses sin intereses
`plan_promo`	string	Sí	Código del plan de promoción

Autenticación forzada

Método: POST Endpoint: /Api/v2/banregio/force-auth Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "amount": 200,
  "card": "4456530000001096",
  "exp": "1224",
  "code": "123",
  "code_auth": "123456"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`amount`	integer	Sí	Monto a cobrar
`card`	string	Sí	Número de tarjeta
`exp`	string	Sí	Fecha de expiración en formato `MMYY`
`code`	string	Sí	Código de seguridad
`code_auth`	string	Sí	Código de autorización previo

Reverso

Revierte una transacción previamente procesada. Método: POST Endpoint: /Api/v2/banregio/reversal Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "reverse_cause": "02",
  "folio": "030223085521",
  "reference": "174668718447"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`reverse_cause`	string	Sí	Código de causa del reverso
`folio`	string	Sí	Folio de la transacción original
`reference`	string	Sí	Referencia de la transacción original

Cancelación

Método: POST Endpoint: /Api/v2/banregio/void Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "reference": "169909642133",
  "amount": 200
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`reference`	string	Sí	Referencia de la transacción a cancelar
`amount`	integer	Sí	Monto de la transacción original

Devolución forzada

Método: POST Endpoint: /Api/v2/cobros/void_hard Header requerido: Authorization: Bearer {token} Ejemplo de request:

{
  "medio_id": "K9SY1RQF",
  "subafiliation_id": "8923253",
  "subafiliation_name": "RENE",
  "amount": "15000",
  "reference": "298147138229"
}

Descripción de los campos:

Campo	Tipo	Requerido	Descripción
`medio_id`	string	Sí	Identificador del medio de pago
`subafiliation_id`	string	Sí

COMIENZA AQUÍ

INTEGRACIONES FRONTEND

INTEGRACIONES BACKEND V2

CASOS DE USO

Crear pago con tarjeta

Así se ve para tu cliente

Crear pago con token

Crear pago con token

Obtener transacciones

Cancelar transacción

Obtener estatus de transacción

Banregio

Venta

Venta en meses sin intereses

Autenticación forzada

Reverso

Cancelación

Devolución forzada

​Crear pago con tarjeta

​Así se ve para tu cliente

​Crear pago con token

​Crear pago con token

​Obtener transacciones

​Cancelar transacción

​Obtener estatus de transacción

​Banregio

​Venta

​Venta en meses sin intereses

​Autenticación forzada

​Reverso

​Cancelación

​Devolución forzada

Crear pago con tarjeta

Así se ve para tu cliente

Crear pago con token

Crear pago con token

Obtener transacciones

Cancelar transacción

Obtener estatus de transacción

Banregio

Venta

Venta en meses sin intereses

Autenticación forzada

Reverso

Cancelación

Devolución forzada