Chile Cash Transfer

Learn how to accept Cash transfer in Chile.

Payment typeCach transfer
MarketChile
Customers currenciesCLP
Processing currenciesCLP
Settlement currenciesEUR
RefundNo
PayoutsNo

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 - cash.
  • 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=2500&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=Cash&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=4a031b8354442f6c685a7920320ab9e6ae294328

Step 2. Handle the redirect

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

Response

transactionid=105354514&transid=105354514&status=2000&errormessage=pending&errmsg=pending&amount=2500&price=2500&currency=CLP&orderid=Payabl-Test&redirect_url=&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):

timestamp=1693233005&errorcode=0&errormessage=&transactionid=105352879&type=capture&payment_method=130&
payment_state=credited&orderid=Payabl-Test&security=8676790a274530ae67ccab8a251301718199eaf85c37f642ed12cf037a5c39a0

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=1693309622&type=order&transactionid=105354473