Country availability
PaySafeCard supports tokenization for recurring payments in the following countries:
Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lichtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, United Kingdom.
Prepare for tokenization
PaySafeCard has no setup requirements. Your existing PaySafeCard account will immediately work for recurring payments.
We strongly recommend that you ask explicit permission from the shopper if you intend to make future recurring payments. Being transparent about the payment schedule and the charged amount reduces the risk of complaints.
Set parameters to flag transactions
When you make a /payments request to create a token or pay with a token, you must include:
| Parameter | Description |
|---|---|
| recurringProcessingModel | When you first create a token, recurringProcessingModel indicates what type of recurring payment the token is intended for.For subsequent payments, it indicates the type of recurring payment. Possible values: - CardOnFile: A transaction where shopper’s MyPaysafecard account details are stored to enable one-click or omnichannel journeys, or to offer a faster checkout later. - UnscheduledCardOnFile: A transaction that occurs on a non-fixed schedule and/or have variable amounts. - Subscription: A transaction for a fixed or variable amount, which follows a fixed schedule. Adyen propagates these parameters to Paysafecard. Ensure you choose the most fitting model to ensure maximum conversion. |
| shopperInteraction | Indicates the sales channel through which the shopper gives their account details. For online transactions, this is Ecommerce. For subsequent payments, indicates whether the shopper is a returning customer (ContAuth). |
| shopperReference | Your unique reference for the shopper. Minimum length: three characters. Note that the value is case-sensitive. Do not include personally identifiable information (PII), such as name or email address. |
| storePaymentMethod | When you first create a token, set to true to store the shopper's payment details. For subsequent payments, this parameter is not required. |
Even though the recurringProcessingModel contains the term card, recurring payments for Paysafecard is only supported whenever the shopper authorizes with a MyPaysafecard account (wallet) and not a Paysafecard PIN/card.
Create PaySafeCard tokens
When the preparation is completed, creating and using tokens for PaySafeCard payments is the same as described for tokenization in general:
-
To create a token through a zero-value authorization request, in your initial /sessions or /payments request include:
Parameter Description value Set to 0 when making a zero-value authorization request.
For with-purchase tokenization, simply provide the correct amount and include the below parameters.recurringProcessingModel The type of transactions you can use the stored details for. shopperReference Your unique reference for the shopper. storePaymentMethod The setting for storing the shopper's payment details.
Example /payments request (creating token):
- Proceed as described for tokenization in general: get the shopper reference and the token from the RECURRING_CONTRACT webhook, and use this data in future payments for the shopper. For instructions on obtaining the token, see RECURRING_CONTRACT webhook.
Make payment with existing tokens
In subsequent transactions, use storedPaymentMethodId to provide the token value obtained in the RECURRING_CONTRACT webhook (namely from additionalData.recurring.recurringDetailReference). This is Adyen’s reference to the token / MyPaysafecard account.
The recurringProcessingModel and shopperInteraction indicate a type of recurring processing is taking place (shopperInteraction = contAuth) and the type of recurring model that is applicable (for example Subscription).
Customer data exchange
When the shopper confirms the payment and a MyPaysafecard wallet was used, you will be able to retrieve the customer’s data via Customer Data Exchange. For any zero-amount transactions used to create a recurring relationship, this data will not be returned. For any (subsequent) payments of an amount greater than zero, customer data exchange works as described.
Testing
It is recommended to first test the following scenarios in Adyen's TEST environment:
- Initiate payment with attempt to tokenize
- Receiving the RECURRING_CONTRACT webhook which confirms tokenization
- Processing the different recurring models
- Error handling
Perform the same scenarios in LIVE.
Error handling
For Refusals the two main important errors are:
| Error message | Paysafecard error code | How to proceed |
|---|---|---|
| Insufficient funds on customer PaysafeCard account. | 2004 | There is not enough balance on the MyPaysafecard account. Please try again with a lower amount. (You can also opt in for the “grace period” which will let Paysafecard collect the funds for you from the shopper. Instead of Refused the transaction would be Pending until completed. See details below) |
| Token not valid. | 10033 | The token is no longer valid. This can happen when the token expires if there is more than a year of lack of activity. It’s also possible that the token was never (properly) created. Ask the shopper again to approve recurring payments with a new zero-value authorization request. |