Before diving into advanced features you should have a working app and backend, that can handle purchases in debug-mode. This is described in detail in the readme file, and you can also look at the Android Example app as a reference.
A common practice is to store a credit-card for later use, e.g. for subscriptions, and charge every month. To make this safe & secure you let SwedbankPay store the payment information and only keep a reference, a payment token. This token can later be used to make purchases, and there are two types of tokens that can be created. One for subscriptions, and one for later unscheduled purchases. They are created the same way, by setting generateUnscheduledToken = true or generateRecurrenceToken = true, in the paymentOrder and then either making a purchase or verifying a purchase (set the operation property to PaymentOrderOperation.verify).
val paymentOrder = PaymentOrder(
generateRecurrenceToken = true,
generateUnscheduledToken = true,
...
//create the paymentOrder as usual by calculating price, etc
)
When expanding the paid property of this verified or purchased payment, there is an array with tokens one can save for later use. Here is an abbreviated example of what is received:
{
"paymentOrder": {
...
"paid": {
...
"tokens": [
{
"type": "recurrence",
"token": "a7d7d780-98ba-4466-befe-e5428f716c30",
"name": "458109******3517",
"expiryDate": "12/2030"
},
{
"type": "unscheduled",
"token": "0c43b168-dcd5-45d1-b9c4-1fb8e273c799",
"name": "458109******3517",
"expiryDate": "12/2030"
}
]
}
}
}Then, to make an unscheduled purchase you simply add the unscheduledToken, or the recurrenceToken to the paymentOrder request. Obviously these purchases and the expanding of tokens is only needed to be done on the backend.
More info on unscheduled purchases.
More info on recurring purchases.
Customer relationship is different depending on type of merchant. Enterprise accounts supply a customer's email and phone (msisdn), while PaymentsOnly need to generate a token.
Enterprise merchant can simply supply the email and phone of the customer to let SwedbankPay match the customer internally and let the customer store card information if desired.
val paymentOrder = PaymentOrder(
payer = PaymentOrderPayer(
email = "[email protected]",
msisdn = "+46739000001",
payerReference = unique-identifier
),
...
//create the paymentOrder as usual by calculating price, etc
)
Now the customer has the option to store card numbers or select one of the previously stored cards. More info in the documentation.
All you have to do is to supply a unique identifier in the payerReference property of the payer, and set generatePaymentToken to true. Supply these in the paymentOrder when starting a new payment.
val paymentOrder = PaymentOrder(
generatePaymentToken = true,
payer = PaymentOrderPayer(
payerReference = unique-identifier
)
...
)
Just this tiny addition will make the SDK do most of the heavy lifting for you, and the customer can have the card details stored in a safe manner without sensitive information ever even touching your servers. More details in the one-click payments documentation.
After successful purchase (or verification), you can retrieve the token and reuse it in the future. Then payments will automatically start with the previous payment method, and all the information filled in. Just a button to press to accept the payment.
Retrieve the token by expanding the "paid" property of a previous successful payment, preferably you do this only on the backend, and then supply this token for the next purchase. To see this in action, the merchant backend has an endpoint called "/expand" that takes a "resource" (in this case the paymentId), and an array of properties to expand. You get a payment order back, and in the expanded paid property there is a "tokens" array (if the customer agreed to let you store the information).
Read more on expanding properties here.
Create the next payment order with the token like this:
val paymentOrder = PaymentOrder(
paymentToken = true,
payer = PaymentOrderPayer(
payerReference = unique-identifier
)
...
)
Now the payment menu will just show a purchase button and the payment method.
