Attributes

• 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
  If amount=”0“, the payment amount is the value of the voucher.
  Other amount values are validated against the amount of the voucher. If they match, the payment is accepted. Otherwise, it is rejected.
• currency
• paymentOption.alternativePaymentMethod class containing:
  • paymentMethod: “apmgw_Abon“,
  • abon_voucherNumber: “<Abon 16-digit voucher number>”
• deviceDetails class containing: ipAddress
• billingAddress class containing: firstName, lastName, email, address
• userDetails class 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

1. The payment flow begins on your payment page when the user selects the Abon payment method and enters their 16-digit Abon voucher number.
2. The user must accept the terms and conditions to make the payment.
3. 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.