COPYandPAY Registration Tokens

Last updated:November 15, 2026

COPYandPAY allows you to securely collect and store (non-)card data from shoppers for future usage e.g. recurring payments, one-click payments.

To better understand registration tokens in eCommerce, please read Tokenization Guide.
To use network tokens issued by the card networks for your payments, please refer to COPYandPAY Network Tokens.

Use cases

Standalone tokenization

The merchant collects card data from the shopper via the tokenization widget and initiates the registration tokenization. No payment request/flow is involved. A registration token is synchronously provisioned and returned to the merchant so it can be stored. The registration token can then be used in subsequent payments.


How it works

Prepare the checkout

Send the request parameters server-to-server to prepare the registration form.

Create the registration form

Display the registration form on your checkout page. Shopper submits the card information to create registration token.

Get the registration status

Find out if the registration token was successful.

OPTIONAL

Send payment or authorization using the token

Authorize (PA) or send (DB) payment using the stored registration token.

Transactions:
RG
RG
DB
DB
or
PA
PA

1. Prepare the checkout

Perform a server-to-server POST request to prepare the checkout with the required customer data, including createRegistration=true but excluding paymentType. The response to a successful request is an id required in the second step to create the registration form.

Sample request:

2. Create the registration form

Create the registration form by adding the following lines of HTML/JavaScript to your page:

  • With the checkoutId received from first step
    <script src="https://eu-test.oppwa.com/v1/paymentWidgets.js?checkoutId={checkoutId}/registration"></script>
  • With the shopperResultUrl as the page on your site where the end consumer should be redirected after the tokenization is complete
    <form action="{shopperResultUrl}" class="paymentWidgets" data-brands="VISA MASTER AMEX"></form>

Sample form:

3. Get the registration status

Once the tokenization request is processed, the customer is redirected to your shopperResultUrl along with a GET parameter resourcePath.

resourcePath=/v1/checkouts/{checkoutId}/registration

Sample request:

4. Send payment or authorization using the token

Perform a server-to-server POST request over the registration token retrieved in the previous step. Alternatively, use one-click checkout to authorize the payment with a selected stored registration token.

To create a Card on File agreement with the registered card, send this first payment as the initial cardholder-initiated transaction (CIT · INITIAL) by adding the standingInstruction parameters. The agreement type determines how the stored card can be used later.

Card on File agreement type
Unscheduled Recurring Installment

Select the pills to see how the standing-instruction parameters and the sample request below change for each agreement type. Unscheduled covers one-click payments, once-off industry practice payments and merchant-initiated payments with irregular recurrence; Recurring and Installment cover merchant-initiated charges on a fixed schedule.

Cardholder creates agreement (CIT · INITIAL)

				

Sample request:

What this creates
The Card on File agreement is established with this initial CIT and the platform stores the Scheme ID for you. Storing standingInstruction.initialTransactionId and standingInstruction.agreementId in your own system is optional. They are saved together with the card and agreement in the registration token, and are added automatically to each following MIT transaction. For all parameters see the COF parameter reference and the Card on File guide.

See also