Implement gift cards (prepaid cards)
This page outlines the basics of using prepaid cards via Netaxept and gives you instructions needed for a fluent implementation.
Before you start
- Nets Prepaid Cards are only available for merchants in Denmark, Norway, Sweden and Finland.
- Supported payment currencies are DKK, NOK, SEK and EUR.
- Prepaid cards are not supported with single-page payment windows or custom payment window templates.
- Only one-off payments are supported, not recurring payments.
- Prepaid cards are considered non-refundable so the Process(CREDIT) call is not supported.
Nets Prepaid Card is a card storing a certain amount of money for customers to pay for purchases at your webshop. When activated, your customers can pay in your webshop with these prepaid cards.
How to process gift card payments
When the customer is shopping online and is moving to the payment phase, send the Register call to Netaxept. Depending on your technical API implementation, the payment method will be selected either on your webshop site or on the Netaxept payment window.
If the customer chooses the payment method on your webshop site, include the
NetsPrepaidCard parameter in Register call's Payment method action list element.
If the payment method is selected on the Netaxept payment window, the Prepaid card option is displayed in the payment window together with your other supported payment methods.
After the successful Register call, perform the Terminal call to send the customer to the Netaxept payment window. When customers choose to pay with prepaid card, Netaxept inguiries the card balance from the prepaid backend system and displays the card's balance in the payment window.
If the transaction amount is less than the card balance, customers can enter their prepaid card number and click pay to complete the transaction.
If the transaction amount is higher than the card balance, then the payment window will prompt a message to use another payment method to pay the remaining amount. This is called split transaction and will be explained in more detail below.
After the Terminal phase, perform the Process(SALE) call to debit the amount from the prepaid card. Refunds are not supported for prepaid cards.
Your customers can pay their single purchase with 1 or multiple (as many as they want) prepaid cards and one payment card. The prepaid cards must be used first.
As mentopned above, the Netaxept payment window shows how much money your customers have on their prepaid card. If the prepaid card's balance is less than the transaction amount, the payment window will prompt a message and the remaining amount can be paid by using another additional payment method after clicking "Next" in the payment window. The back up payment method can be another prepaid card or a payment card.
After your customers have chosen their second card, they are directed again to the payment window to enter the card details. If the second payment option is a prepaid card as well and its balance is still not sufficient, these steps are repeated: the process will continue as described above.
Once the remaining amount is fully paid, the Terminal call's response will be
OK. After this, you need to perform the Process(SALE) call which will process all the split (child) transactions created during the Terminal phase.
You can view the split transaction details in the Netaxept Admin portal by clicking the prepaid logo to see the child transactions. Click the History tab to see the transaction amounts for child transactions.
You can also run the Query call to fetch the child transaction details.