Transfer

（payProduct=12）

The address of the request

The name of the environment	URL
SandBox	POST http://8.130.9.219:8899/api/supefina/transactions/payout
Formal environment	POST https://api.supefina.net/api/supefina/transactions/payout

How the request is made

Request header

Key	Value
Content-Type	application/json

Request body

Variable name	type	Required	description
countryId	String	Yes	Country number Reference: Dictionary table - country number Chile, CHL
merId	String	Yes	Merchant ID Merchant ID acquisition path: Supefina Merchant Background - Merchant Management - Basic Information - Merchant ID
payProduct	String	Yes	Payment type Transfer：12
currency	String	Yes	Currency Reference: Dictionary Table - Currency Chilean Peso: CLP
merOrderNo	String	Yes	Merchant order number
orderAmount	String	Yes	The amount of the order The unit is pesos, and only integers are supported
customerName	String	Yes	Username
customerEmail	String	Yes	The user's email address
customerPhone	String	Yes	User phone
customerIdentification	String	Yes	User ID number (8 or 9 digits of the RUT ID number), The last digit can be a number or letter K from 0-9, and special characters are now supported Example: 13251657-K
customerAddress	String	Yes	User's address
accountType	Strin	Yes	Beneficiary account type 00--Corriente (Current Account) 01--Ahorro (Savings Account) 02-- RUT (only 0012-banco estado has this type). 07--View/Account 08--SALARY ACCOUNT
account	String	Yes	Beneficiary account number (when 'bankId' is 0012-banco estado, the maximum number of bank digits is 12 digits, and when the accountType of 0012-banco estado is 02, the account is customerIdentificationThe first 8 digits, example: 26484404)
bankId	String	Yes	Beneficiary's bank number Reference: "Download > Chilean Bank Code".
nonceStr	String	Yes	Random strings The length cannot exceed 32 bits
description	String	Yes	Description of the order
sign	String	Yes	signature For details, please refer to: Signature algorithm
callbackUrl	String	No	Callback address For details, see Notification Callbacks
customerIdentificationType	String	Yes	The type of user ID 02: Tax ID Number --RUT 03: Passport

Sample request

{
    "account": "50257382",
    "accountType": "00",
    "bankId": "0016",
    "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"
}

Response parameters

Variable name	type	description
code	String	Response coding For details, see Response Status Code
data	Object	Response data
amount	BigDecimal	The amount of the order
fee	BigDecimal	Advance handling fee will be charged
merCode	String	Merchant ID
merOrderNo	String	Merchant order number
supefinaOrderNo	String	Supefina order number
transactionStatus	String	Order status Whether the initiation status of the order is successful or not has nothing to do with the real transaction status of the order. 00: The order is successful 04: Failed to place an order
msg	String	Response Information

Sample response

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

Callback notifications

Submission method:POST

Variable name	type	description
amount	String	The amount of the order
countryId	String	Country number Reference: Dictionary table - country number Peru, PER
customerName	String	Beneficiary's name
fee	String	Advance handling fee will be charged
merId	String	Merchant ID
merOrderId	String	Merchant order number
msg	String	message
nonceStr	String	Random strings The length cannot exceed 32 bits
realityAmount	String	Paid-in amount
realityFee	String	Actual handling fee
sign	String	signature
status	String	Transaction status For details, please refer to: Dictionary Table - Trading Order Status
successTime	String	The time at which the transaction was successful
supefinaOrderId	String	Supefina order number
transactionType	String	The type of transaction 01：Payin 02：Payout

An example of a callback notification

{
    "amount": "105.00",
    "countryId": "CHL",
    "customerName": "Test Name",
    "fee": "3.00",
    "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"
}

Callback notification response

After the merchant successfully receives the callback, it needs to return the specified string synchronously: SUCCESS does not return or returns other content by default, and the notification fails As:

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

List of Chilean payment banks

bankId	bankName	Note
0504	Scotiabank Azul	rename（EX：Banco BBVA）
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	New
0009	Banco Internacional	New