Card
POST
Crear Transacción Tarjeta de Crédito
Procesa un pago directo con tarjeta de crédito o débito. Requiere certificación PCI DSS. Usa los datos reales de la tarjeta del cliente para ejecutar el cobro.
POST
https://serviceregister.paymentsway.co/ClientAPI/CrearTransaccionTCSolo disponible para usuarios con certificación PCI y DSS. Maneja los datos de tarjeta únicamente bajo cumplimiento PCI.
Headers
Envía tu Api_key en el header x-api-key.
Parámetros
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
amount | integer | Valor del pago. | Sí |
firstname | string | Nombres del pagador. | Sí |
lastname | string | Apellidos del pagador. | Sí |
card_identification | string | Número de identificación del pagador. | Sí |
identification_type | integer | Tipo de identificación del pagador. | Sí |
card_holder | string | Nombre completo tal como aparece en la tarjeta. | Sí |
card_pan | string | Número de la tarjeta sin espacios ni guiones. | Sí |
card_expiry_year | string | Año de expiración. Ej: "26". | Sí |
card_expiry_month | string | Mes de expiración. Ej: "06". | Sí |
card_cvv | string | Código CVV/CVC de la tarjeta. | Sí |
description | string | Descripción breve de la orden. | Sí |
installments | integer | Número de cuotas. Enviar 1 para pago de contado. | Sí |
external_order | string | Referencia única de la transacción en tu sistema. | Sí |
dynamic_descriptor | string | Texto que aparece en el extracto del cliente. | Sí |
terminal_id | integer | ID de la terminal. | Sí |
form_id | integer | ID del formulario/botón de pago. | Sí |
ip | string | Dirección IP del pagador. | Sí |
autorizacionDatos | boolean | El pagador autoriza usar sus datos para tokenizar la tarjeta. | Sí |
url_ok | string | URL de redirección si el pago es exitoso. | No |
url_ko | string | URL de redirección si el pago falla. | No |
additionalData | object | Datos adicionales que se retornan en el webhook. | No |
Cuerpo de ejemplo
{
"amount" : 300000,
"firstname" : "Pepito",
"lastname" : "Perez",
"card_identification": "1012345678",
"identification_type": 4,
"card_holder" : "PEPITO PEREZ PA",
"card_pan" : "4111111111111111",
"card_expiry_year" : "26",
"card_expiry_month": "06",
"card_cvv" : "123",
"url_ok" : "https://tu-sitio.com/pago-exitoso",
"url_ko" : "https://tu-sitio.com/pago-fallido",
"description" : "Compra en mi tienda",
"installments" : 1,
"external_order" : "trc231566",
"dynamic_descriptor": "Mi Tienda Online",
"terminal_id" : 34,
"form_id" : 34,
"ip" : "192.168.0.1",
"additionalData" : { "ref": "mi-referencia" },
"autorizacionDatos": true
}Ejemplo de petición
const headers = new Headers();
headers.append("x-api-key", "TU_API_KEY");
headers.append("Content-Type", "application/json");
const res = await fetch(
"https://serviceregister.paymentsway.co/ClientAPI/CrearTransaccionTC",
{ method: 'POST', headers, body: JSON.stringify(body), redirect: 'follow' }
);
const resultado = await res.json();
// Si hay url_3ds, redirige para autenticación 3D Secure
if (resultado.url_3ds) {
window.location.href = resultado.url_3ds;
}POSTObtener persona
Busca un cliente ya registrado en el sistema usando su número de documento. Útil para verificar si un usuario ya existe antes de crearlo.
POSTReversar transacción
Anula una transacción aprobada y devuelve el cobro al cliente. El idTransaction es el identificador interno de PaymentsWay, retornado en la respuesta de Crear Transacción Tarjeta de Crédito.