Alpha Bank Bonus Loyalty Program
Alpha Bank Bonus Loyalty
Alpha Bank Bonus Loyalty redemption service is exclusively available for merchants who maintain a corresponding service agreement with Alpha Bank.
The available offers will appear as a selectable option on the payment page across all Nexi XPay channels and integration models, including:
- Hosted Payment Page (HPP)
- E-commerce Plugins (all plugins mentioned in the Plugins for CMS section)
- Build Integration (API)
- Pay By Link
Payment Flow in e-shop
- The cardholder selects the card payment option and is securely redirected to Nexi XPay for the payment.
- By entering the card details, the platform identifies that the card participates in the Alpha Bank Bonus Loyalty program.
- Available redemption offers are presented based on the cardholder’s available points and the transaction amount, allowing the customer to select their preferred redemption offer.
- The transaction is finalized upon selection of the desired offer, and the corresponding amount is subsequently charged.
Example – Payment via Hosted Payment Page (HPP)
Request
To create a sample payment using the Hosted Payment Page (HPP), you can use a request model similar to the following:
code
{ "order": { "orderId": "Sample order ID", "amount": "2000", "currency": "EUR", "language": "ITA", "description": "Sample description", "customerInfo": { "cardHolderName": "Leonardo Da Vinci", "cardHolderEmail": "l.davinci@gxxmxil.com" } }, "paymentSession": { "actionType": "PAY", "captureType": "IMPLICIT", "amount": "2000", "cancelUrl": "{{Web-hook-URL}}", "notificationUrl": "{{Web-hook-URL}}", "resultUrl": "{{Web-hook-URL}}", "language": "ITA", "description": "Apple iPhone 15" }, "expirationDate": "2025-12-26" }
Response
code
"operation": { "additionalData": { "maskedPan": "450903******0005", "authorizationCode": "005697", "cardType": "NONE", "authorizationStatus": "000", "threeDS": "S", "cardExpiryDate": "203001", "totalAwardedPoints": "1529", "rrn": "624713479904", "totalRedemptionAmount": "500", "messageReasonCode": "1510", "transactionType": "CIT_PAY", "totalRedeemedPoints": "800", "xlsTransactionId": "3000021181", "finalAmount": "1500", "securityType": "1", "selectedOffers": [ { "redemptionAmount": "0", "offerName": "100P=ITEM", "offerCode": "14334", "redeemedPoints": "100" }, { "redemptionAmount": "100", "offerName": "300P=1 EURO DISCOUNT", "offerCode": "14336", "redeemedPoints": "300" }, { "redemptionAmount": "400", "offerName": "400P=20% DISCOUNT", "offerCode": "14337", "redeemedPoints": "400" } ], "status": "EXECUTED" }, "operationAmount": "2000", "operationCurrency": "EUR", "operationId": "584716453857462479", "operationResult": "EXECUTED", "operationTime": "2026-09-04 10:10:40.397", "operationType": "AUTHORIZATION", "orderId": "Sample order ID", "paymentCircuit": "VISA", "paymentEndToEndId": "584716453857462479", "paymentInstrumentInfo": "***0005", "paymentMethod": "CARD" }, "state": "PAYMENT_COMPLETE" }
Payment Test
To test the Alpha Bank Loyalty Program service, make sure that the payments are IMPLICIT and use the following API key:
code
eb74f106-6534-426b-9856-235546505d77
Below is the card that can be used to make payments with Loyalty:
| Schema | Card No. | Expiry date | CVV |
|---|---|---|---|
| Visa | 4509 0317 8061 0005 | 01/2030 | 811 |
| Mastercard | 5100 9990 4816 0007 | 06/2027 | 803 |