Peru Cash Transfer
Learn how to accept Cash transfer in Peru.
Payment type | Cach transfer |
Market | Peru |
Customers currencies | PEN |
Processing currencies | PEN |
Settlement currencies | EUR |
Refund | No |
Payouts | No |
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 SPEI.
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. PEN.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: DNI: 8 digits, RUC: 11 digits.nationaltype
: User's identification type RFC or CURP.
You can see a full list of parameters in Pre-Authorization.
Request example
/pay/backoffice/payment_preauthorize&merchantid=gateway_test&amount=12.01¤cy=PEN&orderid=Payabl-Test&
language=en&gender=&lastname=Mann&street=Office+11A,+Swepco+Court,+Griva+Digeni+80&zip=60322
&city=Frankfurt&country=DEU&customerid=&salutation=&title=&firstname=Muster&company=&birthday=&house=&
postbox=&state=&[email protected]&phone=&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¬ification_url=https://api.powercash.de/simulation/billing_
response.php&payment_method=130&nationaltype=RUC&nationalid=50284414727&subject=test+subject&
content=test+content&signature=32d2663f0b0d22e4721915c272a89d6ae87c95f6
Step 2. Handle the redirect
To complete the payment, you need to redirect the customer to the correct URL in the response.
Response
transactionid=105352879&transid=105352879&status=2000&errormessage=pending&errmsg=pending&amount=1.23&
price=1.23¤cy=PEN&orderid=Payabl-Test&redirect_url=https://cert-gateway.kashio.net/e/index.html?
token=59hfczaetyPHUh8XCmUYdx&user_id=787437
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:
type=order&transactionid=105352913&orderid=Payabl-Test×tamp=1693233348&errormessage=Wrong+national+ID
&security=0fdfd0991c1bcd7c14a09af0b46ae7aee1c4c31be68b4a0265f422976353d380&errorcode=-66182
Updated 10 months ago