Chile Bank Transfer

How to use Bank Transfer to submit a payin in Chile.

Payment typeCach transfer
MarketChile
Customers currenciesCLP
Processing currenciesCLP
Settlement currenciesEUR
PayoutsYes

Step 1. Make a transaction request

From your server, make a POST /payment_preauthorize request.

https://sandbox.payabl.com/pay/backoffice/payment_preauthorize

Include in the request parameters below:

🚧

The below parameters are mandatory for Cash Transfer.

  • merchantid: The merchant identification number.
  • orderid: The field orderid is optional and exclusively for the merchant's convenience.
  • amount: The amount field contains the transaction’s total amount. This is the amount that will be transmitted to the authorizing system.
  • currency: The currency field contains the alphanumeric currency code for the transaction, according to ISO 4217, e.g. CLP.
  • payment_method: The payment method id - 130 (or 126 if instructed by tech support).
  • signature: The signature field contains a 40-figure hexadecimal value. This signature value is a checksum designed to protect the merchant account from unauthorized access.
  • email: The customer's email address.
  • custom2: The name of payment method - banktransfer.
  • nationalid: Consumer’s national id, has to satisfy the following regular expression: 9 digts.
  • nationaltype: User's identification type RUT or RUN.
    You can see a full list of parameters in Pre-Authorization.

Request example

/pay/backoffice/payment_preauthorize&merchantid=gateway_test&amount=1.23&currency=CLP&orderid=Payabl-Test&
language=en&gender=&lastname=Mann&street=An+der+Welle+4&zip=60322&city=Frankfurt&country=DEU&customerid=&
salutation=&title=&firstname=Muster&company=&birthday=&house=&postbox=&state=&[email protected]&
phone=XXXXXXXXXX8501&fax=&mobile=&customerip=&custom1=&custom2=BankTransfer&custom3=&
url_return=http://dev-sim-ng.inatec.local/~simdad/InatecResponse/redirect_response.php&url_success=http://dev-sim-ng.inatec.local/~simdad/InatecResponse/success.php&
url_failed=http://dev-sim-ng.inatec.local/~simdad/InatecResponse/failed.php&
notification_url=https://api.powercash.de/simulation/billing_response.php&payment_method=130&
content=test+content&nationaltype=RUT&nationalid=220604497&subject=test+subject&signature=e8bbdfec2365bd0899c0005d0cff4aaa2caf360d

Step 2. Handle the redirect

To complete the payment, you need to redirect the customer to the correct URL in the response.

Response

transactionid=105354488&transid=105354488&status=2000&errormessage=pending&errmsg=pending&amount=1.23&price=1.23&currency=CLP&orderid=Payabl-Test&redirect_url=https://checkout-testv2.pagsmile.com/process&user_id=787896

Step 3. Transaction states

If the customer successfully completed the transaction, you will receive a notification with confirmation.

Notification example (successful transaction):

orderid=PayablTest&errormessage=&payment_state=credited&type=capture&timestamp=1693310407&security=57743d55287887a4f7ad000ff82f67cb2a57e4efa715945cbaa53d043f1a011c&errorcode=0&payment_method=130&transactionid=10535448

If the customer initiated the transaction but didn't finalize it, you will receive a failed notification.

Notification example with error:

orderid=Payabl-Test&errormessage=Wrong+national+type&security=59534d5fb13266360774904d0f8c023dca317a298abc02c0d789861e2bf66e42&errorcode=-66183&timestamp=1693309616&type=order&transactionid=105354472

Payouts

The method allows merchants to send funds to a bank account via wire transfer. In order for this to be done, the merchant needs to submit the bank details of the customer.

Include in a request:

  • currency: CLP
  • account: Customer's bank account
  • document_id: Customer's id
  • document_type: Customer's document type, should be one of RUT, RUN, PAS, CE.
  • bankcountry: CHL
  • bank_code: bank code
  • method: bank transfer
  • account_type: Customer's account type, should be one of CHECKING, SAVINGS, VISTA, RUT, SALARY.
FieldValue FormatAccepted Values
merchantidString[A-Z][0-9]
amountFloat0.00
currencyStringMXN
orderidString[0-9]
languageStringen
lastnameString[A-Z]
streetString*
zipString[A-Z][0-9]
cityString[A-Z]
countryStringCountry Code
firstnameString[A-Z]
stateString[A-Z]
emailString[A-Z][0-9][-&_]@[A-Z][0-9].[A-Z]
custom1
### optional ###
String*
custom2
### optional ###
String*
custom3
### mandatory payment reason ###
String*
payment_methodString130 (or 126 if instructed by tech support)
Payment Method Id
phoneString[0-9]
banknameStringBank Name
accountnumberString[A-Z][0-9]
testmode
### only for testing ###
Stringtrue
testmodecallbackstatus
### only for testing ###
String[PENDING-PROCESSED-ACCEPTED-FINISHED-ERROR]
signatureString*

Request string:

merchantid=test_merchant&amount=1.23&currency=COP&orderid=Inatec-Test&language=en&lastname=Mann&
street=An+der+Welle+4&zip=60322&city=Frankfurt&country=DEU&firstname=Muster&state=HE&email=test%40inatec.com&
custom1=&custom2=&custom3=&payment_method=130&document_id=50284414727&document_type=CC&method=TRANSFIYA&
bankcountry=COL&additional_remark=transfer+money&account_type=PHONE&account=57012345678910&signature=ff09cfa3b2e01e746ddbf19fbab08b30e31ab313
  1. Response:
transactionid=215456949&transid=215456949&status=2000&errormessage=pending&errmsg=pending&amount=100&price=100&currency=BRL&orderid=Payabl-Test&payment_method=130

Error

transactionid=215457170&transid=215457170&status=4001103&errormessage=method%20or%20channel%20is%20inactive&errmsg=method%20or%20channel%20is%20inactive&amount=2&price=2&currency=COP&orderid=Payabl-Test&payment_method=130
  1. Notification:

2.1 Notification example with Error:

errormessage=&bank_code=001&method=BANKTRANSFER&account_holder=Muster+Mann&orderid=Payabl-Test&errorcode=0&transactionid=215456949&timestamp=1689150492&bank_country=BRA&security=b67f198da9d310b956405ff879d098a2e0f8a1728a5ddad6b0e9c4ce3edc9dae&payment_method=130&type=cft

2.2Notification example with Success

errorcode=-5002&method=BANKTRANSFER&account_holder=Muster+Mann&security=389ff24d11207156c43bfc7e9ebc893e12726dda4f5a0aaa27544a8c4c986e7c&payment_method=130&bank_country=BRA&errormessage=rejected+by+bank&orderid=Payabl-Test&type=cft&timestamp=1689154433&bank_code=001&transactionid=215456961

Banks in Chile

Bank nameBank code
Banco de Chile - Edwards001
Banco Internacional009
Banco Estado (Banco del Estado de Chile)012
Scotiabank014
BCI (Bco de Credito e Inv)016
Banco do Brasil017
Itau-Corpbanca027
Banco Bice028
HSBC Bank031
Banco Santiago035
Banco Santander037
Itau Chile039
JP Morgan Chase Bank N.A.041
Banco de La Nacion Argentina043
The Bank of Tokyo-Mitsubishi Ufj, Ltd045
Banco Security049
Banco Falabella051
Deutsche Bank (Chile)052
Banco Ripley053
Rabobank054
Banco Consorcio055
Banco Penta056
Banco Paris057
Banco Ptg Pactual059
Banco Nuevo099
Prepago Los Heroes152
BBVA (Bco Bilbao Vizcaya Arg)504
Banco del Desarrollo507
Coopeuch672

Account number

BankDescription
Banco del Estado de ChileIf the type of account is "Rut Account": Account Payment must be = 8 first digits of the RUT.
ScotiabankThe “No. account ”must contain 10 digits EX: 0037651234 (10 digits: 3 agency + 7 account).
For any other bank or financial institutionA 20-digit CCI interbank account code must be entered. Example: 00219400254640654321 (20 digits).