- METHOD TYPEVoucher
- PAYMENTS
- PAYOUTS
- REFUNDS
- RECURRING
Introduction
Aircash Abon is a platform intended for users that wish to make payments to their Online Provider accounts (such as betting sites, parking services, and GSM topups) via paper coupons that can be bought at points of sale of Aircash Sales Partners (such as cash registers at kiosks and gas stations).
Supported Countries
- Austria
- Belgium
- Bosnia
- Bulgaria
- Croatia
- Cyprus
- Czech Republic
- Denmark
- Estonia
- Finland
- France
- Germany
- Greece
- Hungary
- Ireland
- Italy
- Kosovo
- Latvia
- Lithuania
- Luxembourg
- Macedonia
- Montenegro
- Malta
- Netherlands
- Poland
- Portugal
- Romania
- Serbia
- Slovakia
- Slovenia
- Spain
- Sweden
Supported Currencies
- BAM
- BGN
- CZK
- DKK
- EUR
- HUF
- MKD
- PLN
- RON
- RSD
- SEK
Payment (Deposit) Flow
Follow these steps to perform a payment using Nuvei REST API integration:
1. Generate a sessionToken
Press here for details.
2. Send a /payment
Request
Perform the payment by sending a /payment
request with its mandatory parameters including:
userTokenId
– Unique customer identifier in merchant system.amount
Ifamount
=”0“, the payment amount is the value of the voucher.
Otheramount
values are validated against the amount of the voucher. If they match, the payment is accepted. Otherwise, it is rejected.currency
paymentOption.alternativePaymentMethod
block containing:paymentMethod
: “apmgw_Abon“,abon_voucherNumber
: “<Abon 16-digit voucher number>”
deviceDetails
block containing:ipAddress
billingAddress
block containing:firstName
,lastName
,email
,address
userDetails
block containing:firstName
,lastName
,email
,address
Example /payment
Request
{ "sessionToken":"<sessionToken from /getSessionToken>", "merchantId":"<your merchantId>", "merchantSiteId":"<your merchantSiteId>", "clientRequestId":"<unique request ID in merchant system>", "amount":"102", "currency":"EUR", "userTokenId":"<unique customer identifier in merchant system>", "clientUniqueId":"<unique transaction ID in merchant system>", "paymentOption":{ "alternativePaymentMethod":{ "paymentMethod":"apmgw_Abon", "abon_voucherNumber": "<16-digit voucher number>" } }, "deviceDetails":{ "ipAddress":"<customer's IP address>" }, "billingAddress":{ "firstName":"John", "lastName":"Smith", "email":"[email protected]", "country":"BE" }, "userDetails":{ "firstName":"John", "lastName":"Smith", "email":"[email protected]", "country":"BE" }, "timeStamp":"<YYYYMMDDHHmmss>", "checksum":"<calculated checksum>" }
Abon processes the transaction and returns a transaction notification and status.
Example /payment
Response
{ "internalRequestId": 913985339, "status": "SUCCESS", "errCode": 0, "reason": "", "merchantId": "4273555827014385119", "merchantSiteId": "222058", "version": "1.0", "clientRequestId": "20240212132854", "sessionToken": "103fe11e-06b2-4af7-b494-724b44bc4e8b", "clientUniqueId": "20180327175242", "orderId": "420274599", "userTokenId": "TestToken2", "paymentOption": { "userPaymentOptionId": "104082698", "card": {} }, "transactionStatus": "PENDING", "transactionId": "711000000032057913" }
After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl
, which Nuvei recommends including in the /payment
request.
User Experience
- The payment flow begins on your payment page when the user selects the Abon payment method and enters their 16-digit Abon voucher number.
- The user must accept the terms and conditions to make the payment.
- The Abon voucher is validated against the provided amount (for a merchant that opens the Payment Page using the closed amount option).
If the amounts match, then the payment is accepted.
If the amounts do not match, then the payment is rejected.