- Getting Started
- Tutorials
- Reference
- API Reference
- Basic Payment
- Forex
- Authentication
- Card Account
- Apple Pay
- Virtual Account
- Bank Account
- Token Account
- Customer
- Billing Address
- Merchant Billing Address
- Shipping Address
- Merchant Shipping Address
- Corporate
- Recipient
- Merchant
- Marketplace & Cart
- Airline
- Lodging
- Passenger
- Tokenization
- Recurring Migration
- 3D Secure
- Custom Parameters
- Async Payments
- Webhook notifications
- Job
- Risk
- Response Parameters
- Card On File
- Chargeback
- Transaction Workflows
- Result Codes
- Brands Reference
- Regression Testing
- Data Retention Policy
- API Reference
- FAQ
COPYandPAY Registration Tokens
Last updated:April 5th, 2024
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.
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.
Transactions:
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:
![](/sites/default/files/ajax-loader.gif)
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:
![](/sites/default/files/ajax-loader.gif)
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:
![](/sites/default/files/ajax-loader.gif)
4. Send payment 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.
Sample request:
![](/sites/default/files/ajax-loader.gif)