PSE

（payProduct=12）

Proceso de pago

1. El usuario realiza un pedido en el sitio web/aplicación del comerciante y elige PSE como método de pago;

2. El comerciante envía una solicitud de pago PSE a Supefina;

3. Supefina devuelve la dirección URL de pago PSE;

4. El comerciante abre esta dirección en el navegador del usuario;

5. El usuario sigue las indicaciones de la página para verificar y realizar el pago;

6. El usuario completa el pago con éxito;

7. Supefina notifica al comerciante la información sobre el pago exitoso.

Dirección de solicitud

Entorno	URL
SandBox	POST http://8.130.9.219:8899/api/supefina/transactions/payin
Producción	POST https://api.supefina.net/api/supefina/transactions/payin

Parámetros de solicitud

Encabezado de solicitud

Key	Value
Content-Type	application/json

Cuerpo de solicitud

Nombre de variable	Tipo	Obligatorio	Descripción
countryId	String	Sí	Código del país Referencia：Tabla de diccionario-Código del país Colombia，COL
currency	String	Sí	Moneda Referencia：Tabla de diccionario-Moneda Peso colombiano：COP
orderAmount	String	Sí	Monto del pedido 3000 >= orderAmount <= 2000000 No se admiten decimales
payProduct	String	Sí	Tipo de pago PSE：12
merId	String	Sí	ID del comerciante Ruta para obtener el ID del comerciante: Panel de comerciante Supefina - Gestión de comerciantes - Información básica - ID del comerciante
merOrderNo	String	Sí	Número de pedido del comerciante
sign	String	Sí	Firma Referencia específica: algoritmo de firma
nonceStr	String	Sí	Cadena aleatoria La longitud no puede exceder 32 caracteres
customerEmail	String	Sí	Correo electrónico del usuario El nombre de usuario del correo electrónico no puede estar compuesto solo por números (por ejemplo, [email protected]), y las solicitudes de pago del mismo correo electrónico no pueden superar las 20 veces en un día.
customerName	String	Sí	Nombre del usuario
customerPhone	String	Sí	Teléfono del usuario Debe ser un número de diez dígitos que comience con 3
customerIdentification	String	Sí	Número de identificación del usuario
checkOut	Boolean	Sí	Pasarela de pago true: Se necesita pasarela de pago false: No se necesita pasarela de pago Se recomienda enviar true.
customerAccount	String	No	Cuenta de usuario Obligatorio si checkOutes false.
lastName	String	No	Apellido del usuario Obligatorio si checkOutes false.
customerIdentificationType	String	No	Tipo de identificación de usuario 00：Cédula de Ciudadanía (CC) 01：Cédula de Extranjería (CE) 02：Número de Identificación Tributaria 03：Pasaporte 06：Otras 07：Prueba de ciudadanía 08：Permiso de residencia Obligatorio si checkOutes false.
customerAddress	String	No	Dirección del usuario Obligatorio si checkOutes false.
tipo_persona	String	No	Sujeto de pago Obligatorio si checkOutes false.
bankId	String	No	Código del banco Referencia：https://api.supefina.net/api/supefina/transactions/internal/getEbixuBankList Obligatorio si checkOutes false.
expireTimeL	Long	No	Tiempo de expiración Unidad: segundos; valor predeterminado: 1 día; valor máximo: 30 días; valor mínimo: ninguno
callbackUrl	String	No	Dirección de callback Consultar la instrucción de notificación de callback

Ejemplo de solicitud

{
    "callbackUrl": "https://d3vf2zxd9jv8rh.cloudfront.net/apigate/v6sx2i/api/pay_notice/in_payback/payId/CDEA3CA37DBC4C2CB6301AED14011122",
    "checkOut": true,
    "countryId": "COL",
    "currency": "COP",
    "customerAccount": "60872832",
    "customerEmail": "[email protected]",
    "customerIdentification": "9145652857",
    "customerName": "Aaliyah Rogers",
    "customerPhone": "3073030686",
    "lastName": "cith",
    "merId": "8301113635310326",
    "merOrderNo": "R20240619032018545",
    "nonceStr": "6D9B18BFD37240EB846FC923059D001B",
    "orderAmount": "20000",
    "payProduct": "12",
    "sign": "727D7B7416A570284E97F295DECF8490"
}

Parámetros de respuesta

Nombre de variable	Tipo	Descripción
code	String	Código de respuesta Referencia específica: Códigos de estado de respuesta
msg	String	Mensaje de respuesta
data	Object	Datos de respuesta
merCode	String	ID de comerciante
merOrderNo	String	Número de pedido del comerciante
supefinaOrderId	String	Número del pedido de Supefina
amount	BigDecimal	Monto del pedido
fee	String	Comisión anticipada
identifier	String	Referencia de pago
transactionStatus	String	Estado del pedido. Este estado indica si la solicitud fue exitosa, sin relación con el estado real de la transacción. 00: Pedido exitoso; 04: Pedido fallido.
url	String	Enlace de la transacción

Ejemplo de respuesta

{
    "code": "string",
    "msg": "string",
    "data": {
        "merCode": "string",
        "merOrderNo": "string",
        "supefinaOrderNo": "string",
        "amount": 0,
        "fee": 0,
        "transactionStatus": "string",
        "url": "string",
        "identifier": "string"
    }
}

Notificación de callback

Método de envío: POST

Nombre de variable	Tipo	Descripción
amount	String	Monto del pedido
countryId	String	Código del país Referencia：Tabla de diccionario-Código del país Colombia, COL
customerName	String	Nombre del usuario
fee	String	Comisión anticipada
merId	String	ID del comerciante
merOrderId	String	Número de pedido del comerciante
msg	String	Mensajes
nonceStr	String	Cadena aleatoria La longitud no puede exceder 32 caracteres
realityAmount	String	Monto recibido
realityFee	String	Comisión recibida
sign	String	Firma
status	String	Estado de la transacción Referencia específica: Tabla de diccionario - Estado del pedido de transacción
successTime	Date	Tiempo de éxito de la transacción Hora UTC
supefinaOrderId	String	Número del pedido de Supefina
transactionType	String	Tipo de transacción 01：Payin 02：Payout

Ejemplo de notificación de callback

{
    "amount": "20000.00",
    "countryId": "COL",
    "customerName": "Grace Shaw",
    "fee": "1000.00",
    "merId": "8301409897370054",
    "merOrderId": "R20240619052050314",
    "msg": "",
    "nonceStr": "8b0c8dcd-14b6-4fef-a970-c914dc",
    "realityAmount": "20000",
    "realityFee": "1000.00",
    "sign": "FD1DD91503C4EC282E8CA01591973921",
    "status": "01",
    "successTime": 1718775146000,
    "supefinaOrderId": "2024061900010012b16f19beca043",
    "transactionType": "01"
}

Respuesta de notificación de callback

Después de que el comerciante reciba correctamente la notificación de callback, debe devolver la cadena especificada: SUCCESS. Si no se devuelve o se devuelve otro contenido, se considerará que la notificación ha fallado. Por ejemplo:

public String test(){
	return "SUCCESS";
}

Lista de Bancos de Payin en Colombia

Código	Nombre del banco
1558	BAN100
1059	BANCAMIA S.A.
1040	BANCO AGRARIO
1052	BANCO AV VILLAS
1013	BANCO BBVA COLOMBIA S.A.
1032	BANCO CAJA SOCIAL
1066	BANCO COOPERATIVO COOPCENTRAL
1051	BANCO DAVIVIENDA
1001	BANCO DE BOGOTA
1023	BANCO DE OCCIDENTE
1062	BANCO FALABELLA
1063	BANCO FINANDINA S.A. BIC
1012	BANCO GNB SUDAMERIS
1006	BANCO ITAU
1060	BANCO PICHINCHA S.A.
1002	BANCO POPULAR
1065	BANCO SANTANDER COLOMBIA
1069	BANCO SERFINANZA
1303	BANCO UNION antes GIROS
1007	BANCOLOMBIA
1061	BANCOOMEVA S.A.
1283	CFA COOPERATIVA FINANCIERA
1009	CITIBANK
1370	COLTEFINANCIERA
1292	CONFIAR COOPERATIVA FINANCIERA
1291	COOFINEP COOPERATIVA FINANCIERA
1289	COTRAFA
1097	DALE
1551	DAVIPLATA
1637	IRIS
1070	LULO BANK
1801	MOVII S.A.
1507	NEQUI
1811	RAPPIPAY
1019	SCOTIABANK COLPATRIA
1815	ALIANZA FIDUCIARIA
1071	BANCO J.P. MORGAN COLOMBIA S.A.
1047	BANCO MUNDO MUJER S.A.
1816	CREZCAMOS S.A. COMPAÑÍA DE FINANCIAMIENTO
1804	UALÁ