Pago simple con Tarjeta de Crédito

Escenario

Tu comercio quiere aceptar tarjetas de crédito (Visa, Mastercard, AmEx, Diners). Sin pagos mixtos, sin fees adicionales.

Request

{
  "InformacionPago": {
    "flt_total_con_iva": 150000,
    "flt_valor_iva": 23950,
    "str_id_pago": "ORDEN-TC-001",
    "str_descripcion_pago": "Compra en mi tienda",
    "str_email": "cliente@ejemplo.com",
    "str_id_cliente": "1020304050",
    "str_tipo_id": "1",
    "str_nombre_cliente": "Juan",
    "str_apellido_cliente": "Perez",
    "str_telefono_cliente": "3001234567"
  },
  "InformacionSeguridad": {
    "int_id_comercio": 31416,
    "str_usuario": "UsuarioProd",
    "str_clave": "ClaveProd",
    "int_modalidad": -1
  },
  "AdicionalesPago": [],
  "AdicionalesConfiguracion": [
    { "int_codigo": 50, "str_valor": "2701" }
  ]
}

Aunque tu flujo sea solo TC, envía el código 50 (código de servicio PSE) si tu comercio tiene PSE habilitado. Si quieres ocultar PSE en este pago específico, agrega también:

{ "int_codigo": 103, "str_valor": "1" }  // Desactivar PSE

Flujo esperado

Usuario llega al checkout, click “Pagar con Tarjeta”.
Backend llama POST /InicioPago.
Redirige a str_url.
Usuario digita número, vencimiento, CVV, cuotas.
Franquicia autoriza (síncrono en la mayoría de casos).
Callback → VerificacionPago → estado final.

Posibles estados

Estado	Probabilidad	Acción
`1` (aprobado)	80-90%	Entregar producto.
`4001` (pendiente CR)	5-15%	Revisión antifraude. Sonda.
`1000` (rechazado)	5-10%	Permitir reintento con otra tarjeta.
`4000/4003`	1-3%	Tratar como rechazo.

Opciones útiles

Ocultar el campo “nombre en tarjeta”

{ "int_codigo": 111, "str_valor": "1" }

Algunos bancos no requieren ese campo. Quitarlo reduce fricción.

Solo aceptar TC en este pago

{ "int_codigo": 103, "str_valor": "1" }  // Desactivar PSE para este pago

Datos que recibes tras aprobar

En str_res_pago encontrarás (para int_id_forma_pago: 32):

Últimos 4 dígitos de la tarjeta.
Franquicia ("Visa", "Master Card", etc.).
Código de aprobación.
Número de recibo.

Guárdalos para conciliación.

Ver también

Cobro en dólares para TC

Si vendes a clientes internacionales.

Empieza ahora

Zonapay - Pasarelas de pagos

Zonarecaudo

Zonaexpress - Formulario de pago

Tokenización

Link de cobro

Pago simple con Tarjeta de Crédito

Escenario

Request

Flujo esperado

Posibles estados

Opciones útiles

Ocultar el campo “nombre en tarjeta”

Solo aceptar TC en este pago

Datos que recibes tras aprobar

Ver también

Cobro en dólares para TC

​Escenario

​Request

​Flujo esperado

​Posibles estados

​Opciones útiles

​Ocultar el campo “nombre en tarjeta”

​Solo aceptar TC en este pago

​Datos que recibes tras aprobar

​Ver también

Cobro en dólares para TC

Escenario

Request

Flujo esperado

Posibles estados

Opciones útiles

Ocultar el campo “nombre en tarjeta”

Solo aceptar TC en este pago

Datos que recibes tras aprobar

Ver también