Transfer
（payProduct=12）
Dirección de solicitud
SandBox
POST
https://api.supefina.tech/api/supefina/transactions/payin
Producción
POST
https://api.supefina.net/api/supefina/transactions/payin
Formas de solicitud
Encabezado de solicitud
Content-Type
application/json
Cuerpo de solicitud
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
orderAmount
String
Sí
Monto del pedido Solo se admiten números enteros
customerName
String
Sí
Nombre del usuario
customerEmail
String
Sí
Correo electrónico del usuario
customerPhone
String
Sí
Teléfono del usuario
customerIdentification
String
Sí
Número de documento del usuario (RUT con 9 dígitos),
sin símbolos especiales, por ejemplo: 264844045
customerAddress
String
Sí
Dirección del usuario
accountType
String
Sí
Tipo de cuenta del beneficiario:
00 -- Corriente
01 -- Ahorro
02 -- Vista/Cuenta RUT (solo disponible en 0012 - Banco Estado)
07--Vista/Cuenta
08--SALARY ACCOUNT
account
String
Sí
Número de cuenta del beneficiario (cuando 'bankId' es 0012 -banco estado, el número de dígitos del banco es de hasta 12, y cuando accountType de 0012 - banco estado es 02, account son los primeros 8 dígitos del customerIdentification, por ejemplo: 26484404)
bankId
String
Sí
Número de banco del beneficiario
Referencia: "Descargar" > Códigos de los bancos de Chile
bankName
String
Sí
Nombre de banco del beneficiario
Referencia: "Descargar" > Códigos de los bancos de Chile
nonceStr
String
Sí
Cadena aleatoria
La longitud no puede exceder 32 caracteres
description
String
Sí
Descripción del pedido
customerIdentificationType
String
Sí
Tipo de Documento del Usuario
02: Número de Identificación Fiscal
03: Pasaporte
Ejemplo de solicitud
{
"account": "50257382",
"accountType": "00",
"bankId": "0016",
"bankName": "BCI",
"countryId": "CHL",
"currency": "CLP",
"customerAddress": "test online 01",
"customerEmail": "[email protected]",
"customerIdentification": "111111111",
"customerName": "Ignacio Andres Donoso Pinochet",
"customerPhone": "923122312",
"description": "111111",
"merId": "8202411379430193",
"merOrderNo": "testonline",
"nonceStr": "12312",
"orderAmount": "1000",
"payProduct": "12",
"sign": "CA82EC94A7ED1519812C95E564C7900B",
"customerIdentificationType": "00"
}Parámetros 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
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
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
reference
String
Identificador
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
supefinaOrderId
String
Número del pedido de Supefina
transactionType
String
Tipo de transacción
01：Payin
02：Payout
identifier
String
Referencia de pago Clabe
Ejemplo de notificación de callback
{
"amount": "105.00",
"countryId": "CHL",
"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";
}Lista de bancos de payout en Chile
0504
Scotiabank Azul
0028
Banco Bice
0055
Banco Consorcio
0001
Banco de Chile
0012
Banco Estado
0051
Banco Falabella
0039
Banco Itau
0053
Banco Ripley
0049
Banco Security
0016
BCI
729
Caja Los Heroes
0672
Coopeuch
732
Los Andes
875
Mercado Pago
0037
Santander
0014
Scotiabank
730
Tenpo
0507
Banco del desarrollo
0009
Banco Internacional
027
Itau-Corpbanca
031
Hsbc Bank
057
Banco Paris
0152
Prepago Los Heroes
0738
Global 66
Última actualización