Tarjetas y datos de prueba

Antes de salir a producción puedes simular transacciones en el entorno de staging sin realizar cargos reales. Usa los siguientes datos para probar los distintos escenarios de pago.

La URL base y las credenciales de autenticación son las mismas que se describen en las secciones Entornos y URLs y Autenticación y seguridad.

Autenticación

Tu servidor llama a PayCode con tu API Key y obtiene un token de sesión temporal que deberás usar en todas las peticiones siguientes. Método: GET Endpoint: /Api/v2/auth/login Header requerido:

Header	Valor
`Authorization`	Tu API Key

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,
  "flag_3ds": false,
  "card": {
    "card_number": "4242424242424242",
    "sec_code": "123",
    "exp_month": "02",
    "exp_year": "31",
    "cardholder_name": "Raul Juarez Monroy",
    "msi": null
  },
  "client": {
    "num_cel": "5555555555",
    "first_name": "demo",
    "paternal_surname": "paycode",
    "maternal_surname": "paycode",
    "concept": "prueba"
  }
}

Descripción de los campos:

Campo	Descripción
`amount`	Monto a cobrar
`save_card`	Indica si la tarjeta se tokeniza para cobros futuros. Por defecto `false`
`flag_3ds`	Indica si se utiliza autenticación 3DS. Por defecto `false`
`card`	Datos de la tarjeta: número, código de seguridad, fecha de expiración, nombre del titular y meses sin intereses si aplica
`client`	Datos del cliente

Datos de prueba para los campos de la tarjeta:

Campo	Valor de prueba
`card_number`	`4242424242424242`
`sec_code`	`123`
`exp_month`	`02`
`exp_year`	`31`
`cardholder_name`	Cualquier nombre

Posibles respuestas: Cargo aprobado:

{
  "success": true,
  "error": "",
  "display_message": "Aprobada por HUB Banregio (modo prueba)",
  "reference_number": "178330651",
  "track_code": "178630651",
  "card_type": "CREDITO",
  "result_code": "00"
}

Cargo rechazado, número de tarjeta inválido:

{
  "success": true,
  "error": "",
  "display_message": "Número de tarjeta inválido",
  "reference_number": "178346272211",
  "track_code": "178346272211",
  "card_type": "CREDITO",
  "result_code": "14"
}

Cargo aprobado con tokenización exitosa:

{
  "success": true,
  "error": "",
  "display_message": "Aprobado",
  "reference_number": "178346306751",
  "track_code": "178346306751",
  "card_type": "CREDITO",
  "result_code": "00",
  "token_card": "XXXXXXXXXXXXXXXXXXXXX"
}

El campo token_card aparece en la respuesta únicamente cuando save_card es true en el request. Este token puede usarse para cobros futuros sin que el cliente tenga que ingresar sus datos de tarjeta nuevamente.

Pago con token

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

{
  "amount": "1.00",
  "token_card": "XXXXXXXXXXXXXXXXXXX"
}

Descripción de los campos:

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

Posibles respuestas: Cargo aprobado:

{
  "success": true,
  "display_message": "Aprobada por HUB Banregio (modo prueba)",
  "reference_number": "178369869513",
  "track_code": "178369869513",
  "card_transaction_id": 21508,
  "metadata": null
}

Cargo rechazado, token no encontrado:

{
  "success": false,
  "data": [],
  "msg": "No se encontró el token: tVoOPm4gSNSJEDjA5sC6ogQz2l7-zQxxOvzrLkToWOM%3D"
}

COMIENZA AQUÍ

INTEGRACIONES FRONTEND

INTEGRACIONES BACKEND V2

CASOS DE USO

Autenticación

Pago con tarjeta

Pago con token

​Autenticación

​Pago con tarjeta

​Pago con token

Autenticación

Pago con tarjeta

Pago con token