All-Checkout

（payProduct=05）

Proceso de pago

  1. El usuario realiza un pedido en el sitio web/aplicación del comerciante y selecciona el pago All-Checkout;

  2. El comerciante inicia una solicitud de pago All-Checkout a Supefina;

  3. Supefina devuelve la dirección URL de pago All-Checkout;

  4. El comerciante abre la dirección en el lado del usuario;

  5. El usuario verifica y paga según las instrucciones de la página;

  6. El usuario paga correctamente;

  7. Supefina notifica al comerciante el éxito del pago.

Dirección de solicitud

Entorno
URL

SandBox

POST https://api.supefina.tech/api/supefina/transactions/payin

Producion

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 All-Checkout：05

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 comerciantes - Información Básica - ID de 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. correo electrónico para más de 20 solicitudes de pago al día.

customerName

String

Sí

Nombre del usuariorio

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

description

String

Sí

Descripción

No puede contener símbolos especiales, y la longitud no debe exceder los 200 caracteres.

Ejemplo de solicitud

{
    "callbackUrl": "http://8.130.9.219:8899/api/supefina/transactions/test/zx",
    "checkOut": true,
    "countryId": "COL",
    "currency": "COP",
    "customerEmail": "[email protected]",
    "customerIdentification": "123456",
    "customerName": "test",
    "customerPhone": "1234567890",
    "merId": "8202325858590233",
    "merOrderNo": "toppay001",
    "nonceStr": "123",
    "orderAmount": "3001",
    "payProduct": "05",
    "sign": "0F569F49F68884C3E490E44BB8FCF68E",
    "description":"Supefina"
}

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

customerName

String

Nombre del usuario

fee

String

Comisión anticipada

identifier

String

Referencia de pago Clabe

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",
    "identifier": "706180968985601627",
    "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";
}
AnteriorCashSiguientePerú

Última actualización