Transfer

（payProduct=12）

Dirección de solicitud

Nombre del entorno	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/payout
Producción	POST https://api.supefina.net/api/supefina/transactions/payout

Formas 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 Ecuador，ECU
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
payProduct	String	Sí	Tipo de pago Transfer：25
currency	String	Sí	Moneda Referencia：Tabla de diccionario-Moneda Dólar estadounidense：USD
merOrderNo	String	Sí	Número de pedido del comerciante
orderAmount	String	Sí	Monto del pedido 0>= orderAmount <= 10,000
customerEmail	String	Sí	Correo electrónico del usuario
customerPhone	String	Sí	Teléfono del beneficiario
customerName	String	Sí	Nombre del usuario
customerIdentificationType	String	No	Tipos de documentos de identificación del usuario: 07: Carnet de identidad (CI) 10: Número de pasaporte (PP) (solo para Cash) 03: Identificación de pasaporte (PAS) (solo para BankTransfer) 02: Registro Único del Contribuyente (RUC)
customerIdentification	String	Sí	Número de identificación del usuario
bankId	String	Sí	Número de banco del beneficiario Referencia: ver "Descargas" > "Códigos bancarios de Ecuador"
bankName	String	Sí	Nombre del banco del beneficiario Referencia: ver "Descargas" > "Códigos bancarios de Ecuador"
accountType	String	Sí	Tipo de cuenta 00: Cuenta corriente 01: Cuenta de ahorros
account	String	Sí	Número de cuenta del beneficiario
app	String	Sí	Nombre de la aplicación de pedidos
nonceStr	String	Sí	Cadena aleatoria La longitud no puede exceder 32 caracteres
sign	String	Sí	Firma Referencia específica: algoritmo de firma
callbackUrl	String	No	Dirección de callback Consultar la instrucción de notificación de callback
customerAddress	String	No	Dirección del cliente
description	String	No	Descripción del pedido

Ejemplo de solicitud

{
    "countryId": "ECU",
    "merId": "8101124378884582",
    "payProduct": "12",
    "currency": "USD",
    "merOrderNo": "payouttest0016",
    "orderAmount": "5",
    "customerEmail": "[email protected]",
    "customerPhone": "123456789",
    "customerName": "testName",
    "customerIdentificationType": "07",
    "customerIdentification": "7588708477",
    "bankId": "0010",
    "bankName": "BANCO PICHINCHA C.A.",
    "accountType": "01",
    "account": "89831914679785",
    "app": "supefina",
    "nonceStr": "12312",
    "sign": "R9d1Enp0XUS5YMwv0EP$blm9mWTWwyoB"
}

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
data	Object	Datos de respuesta
amount	BigDecimal	Monto del pedido
fee	BigDecimal	Comisión anticipada
merCode	String	ID de comerciante
merOrderNo	String	Número de pedido del comerciante
supefinaOrderNo	String	Número de pedido de Supefina
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.
msg	String	Mensaje de respuesta

Ejemplo de respuesta

{
    "code": "200",
    "data": {
        "amount": 105.00,
        "fee": 3.00,
        "merCode": "8202157333970291",
        "merOrderNo": "8485233309941743872",
        "supefinaOrderNo": "2024052001860105b0fae306a6e43",
        "transactionStatus": "00"
    },
    "msg": "success "
}

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 Perú，PER
customerName	String	Nombre del beneficiario
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	Descripción de la respuesta
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

Ejemplo de notificación de callback

{
    "amount": "105.00",
    "countryId": "ECU",
    "customerName": "Test Name",
    "fee": "3.00",
    "identifier": "706180968985601627",
    "merId": "8202157333970291",
    "merOrderId": "8485233309941743872",
    "msg": "success",
    "nonceStr": "76abf1f3-0486-4c1e-ac2a-1d9e17",
    "realityAmount": "105.00",
    "realityFee": "3.00",
    "sign": "11D7CBC5B0C337F904F227628813F5DE",
    "status": "01",
    "successTime": 1716249060000,
    "supefinaOrderId": "2024052001860105b0fae306a6e43",
    "transactionType": "02"
}

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";
}