Chile Bank Transfer
How to use Bank Transfer to submit a payin in Chile.
| Payment type | Cach transfer |
| Market | Chile |
| Customers currencies | CLP |
| Processing currencies | CLP |
| Settlement currencies | EUR |
| Payouts | Yes |
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¤cy=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¤cy=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×tamp=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×tamp=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: CLPaccount: Customer's bank accountdocument_id: Customer's iddocument_type: Customer's document type, should be one of RUT, RUN, PAS, CE.bankcountry: CHLbank_code: bank codemethod: bank transferaccount_type: Customer's account type, should be one of CHECKING, SAVINGS, VISTA, RUT, SALARY.
| Field | Value Format | Accepted Values |
|---|---|---|
| merchantid | String | [A-Z][0-9] |
| amount | Float | 0.00 |
| currency | String | MXN |
| orderid | String | [0-9] |
| language | String | en |
| lastname | String | [A-Z] |
| street | String | * |
| zip | String | [A-Z][0-9] |
| city | String | [A-Z] |
| country | String | Country Code |
| firstname | String | [A-Z] |
| state | String | [A-Z] |
| String | [A-Z][0-9][-&_]@[A-Z][0-9].[A-Z] | |
| custom1 ### optional ### | String | * |
| custom2 ### optional ### | String | * |
| custom3 ### mandatory payment reason ### | String | * |
| payment_method | String | 130 (or 126 if instructed by tech support) Payment Method Id |
| phone | String | [0-9] |
| bankname | String | Bank Name |
| accountnumber | String | [A-Z][0-9] |
| testmode ### only for testing ### | String | true |
| testmodecallbackstatus ### only for testing ### | String | [PENDING-PROCESSED-ACCEPTED-FINISHED-ERROR] |
| signature | String | * |
Request string:
merchantid=test_merchant&amount=1.23¤cy=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
- Response:
transactionid=215456949&transid=215456949&status=2000&errormessage=pending&errmsg=pending&amount=100&price=100¤cy=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¤cy=COP&orderid=Payabl-Test&payment_method=130
- Notification:
2.1 Notification example with Error:
errormessage=&bank_code=001&method=BANKTRANSFER&account_holder=Muster+Mann&orderid=Payabl-Test&errorcode=0&transactionid=215456949×tamp=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×tamp=1689154433&bank_code=001&transactionid=215456961
Banks in Chile
| Bank name | Bank code |
|---|---|
| Banco de Chile - Edwards | 001 |
| Banco Internacional | 009 |
| Banco Estado (Banco del Estado de Chile) | 012 |
| Scotiabank | 014 |
| BCI (Bco de Credito e Inv) | 016 |
| Banco do Brasil | 017 |
| Itau-Corpbanca | 027 |
| Banco Bice | 028 |
| HSBC Bank | 031 |
| Banco Santiago | 035 |
| Banco Santander | 037 |
| Itau Chile | 039 |
| JP Morgan Chase Bank N.A. | 041 |
| Banco de La Nacion Argentina | 043 |
| The Bank of Tokyo-Mitsubishi Ufj, Ltd | 045 |
| Banco Security | 049 |
| Banco Falabella | 051 |
| Deutsche Bank (Chile) | 052 |
| Banco Ripley | 053 |
| Rabobank | 054 |
| Banco Consorcio | 055 |
| Banco Penta | 056 |
| Banco Paris | 057 |
| Banco Ptg Pactual | 059 |
| Banco Nuevo | 099 |
| Prepago Los Heroes | 152 |
| BBVA (Bco Bilbao Vizcaya Arg) | 504 |
| Banco del Desarrollo | 507 |
| Coopeuch | 672 |
Account number
| Bank | Description |
|---|---|
| Banco del Estado de Chile | If the type of account is "Rut Account": Account Payment must be = 8 first digits of the RUT. |
| Scotiabank | The “No. account ”must contain 10 digits EX: 0037651234 (10 digits: 3 agency + 7 account). |
| For any other bank or financial institution | A 20-digit CCI interbank account code must be entered. Example: 00219400254640654321 (20 digits). |
Updated almost 2 years ago
