PSE
POST
Crear Transacción PSE
Inicia una transacción de débito bancario a través de PSE (Pagos Seguros en Línea). El cliente es redirigido al portal de su banco para autorizar el pago.
POST
https://serviceregister.paymentsway.co/ClientAPI/CrearTransaccionPSESolo disponible para usuarios con certificación PCI y DSS. Obtén primero el listado de bancos con ObtenerListadoBancos.
Headers
Envía tu Api_key en el header x-api-key.
Parámetros
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
amount | integer | Valor del pago en pesos colombianos. | Sí |
PersonType | string | "0" Persona Natural · "1" Persona Jurídica (en formato string). | Sí |
identification_type | integer | Tipo de identificación del pagador (ver ObtenerTiposIdentificacion). | Sí |
Documento | string | Número de identificación del pagador. | Sí |
Correo | string | Email del pagador. | Sí |
Nombres | string | Nombres del pagador. | Sí |
Apellidos | string | Apellidos del pagador. | Sí |
Celular | string | Número de celular del pagador. | Sí |
Direccion | string | Dirección del pagador. | Sí |
external_order | string | Identificador único de la transacción en tu sistema. | Sí |
CodigoBanco | string | Código del banco (obtenido de ObtenerListadoBancos). | Sí |
NombreBanco | string | Nombre del banco (obtenido de ObtenerListadoBancos). | Sí |
entityurl | string | URL a la que redirige al cliente cuando el pago es exitoso. | 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í |
additionalData | object | Datos adicionales que se retornan en el webhook. | No |
Cuerpo de ejemplo
{
"amount" : 30000,
"PersonType" : "0",
"identification_type": 4,
"Documento" : "1012345678",
"Correo" : "cliente@email.com",
"Nombres" : "Ana",
"Apellidos" : "Perez",
"Celular" : "3167225855",
"Direccion" : "Calle 32 # 74-31",
"external_order" : "ORD-PSE-001",
"CodigoBanco" : "10512",
"NombreBanco" : "BANCO DAVIVIENDA",
"entityurl" : "https://tu-sitio.com/pago-exitoso",
"terminal_id" : 34,
"form_id" : 34,
"ip" : "192.168.0.1",
"additionalData" : { "referencia": "mi-referencia" }
}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/CrearTransaccionPSE",
{ method: 'POST', headers, body: JSON.stringify(body), redirect: 'follow' }
);
const resultado = await res.json();
// Redirige al cliente al portal PSE
if (resultado.urlBanco) {
window.location.href = resultado.urlBanco;
}GETListado de bancos
Retorna el catálogo de bancos habilitados para transacciones PSE. Los campos CodigoBanco y NombreBanco retornados aquí se usan directamente en el endpoint Crear Transacción PSE.
GETObtener medios de pago
Retorna el listado de métodos de pago en efectivo habilitados (Efecty, Baloto, etc.). El campo method retornado aquí se envía directamente en Crear Transacción Cash.