Stored Credentials Standard Handling
Nuvei can store and manage a user’s card(s) for you, in which case we handle the stored credentials on your behalf. You simply need to use the userPaymentOptionId
field as explained and demonstrated in User Payment Management (tokenization).
Stored Credentials Advanced Handling
If you store and manage card credentials in your own system, and choose not to use Nuvei, then you will need to send the storedCredentialsMode
field to indicate that the transaction is using stored credentials.
The storedCredentialsMode
field is set on the card
block, which is on the paymentOption
block (paymentOption.card.storedCredentialsMode
). You set this field when calling the /openOrder method (or /payment method if you are using server-to-server). Possible values:
- For the first transaction, in which the card is being stored,
storedCredentialsMode
needs to be set to “0” - For subsequent transactions, in which the stored card is being used,
storedCredentialsMode
needs to be set to “1”