Last updated
Last updated
COPYandPAY is a PCI-DSS compliant payment-form solution, making it both secure and simple-to-integrate. There are just three simple steps required to integrate the card payment method:
Forms are used to collect user information with different element types of input, select, checkboxes, radios buttons and more.
Please note that for a HTTP POST request all the parameters are expected to go into the message body and not into the URL.
To create the payment form, you just need to add the following lines of HTML/JavaScript to your page and populate the following variables:
The checkout'sid
which you received in the response from step 1.
The shopperResultUrl
, is the page on your site where the customer should be redirected to after the payment is processed as well as the brands that shall be available for this payment.
Once the payment has been processed, the customer is redirected to your shopperResultUrl
along with a GET parameter resourcePath
.
Important: The baseUrl must end in a "/", e.g. "https://test.oppwa.com/".
Then, to get the status of the payment, you do a GET request to the baseUrl + resourcePath
, including your authentication parameters.
Example of a resourcePath:
Important: A throttling rule applies for get payment status calls. Per checkout, it is allowed to send two get payment requests in a minute.
We recommend that you verify the following fields from the Payment Status response by comparing the returned values with expected:
ID(s)
Amount
Currency
Brand
Type
A DB is created by sending a POST request over HTTPS to the /v1/checkouts resource. The request should include all required information such as your authentication credentials, the type of transaction, the amount and the payment information such as card details. A DB request effectively combines a PA and capture (CP) request, automatically requesting that the funds are cleared if the authorization was successful.
Please note that for a HTTP POST request all the parameters are expected to go into the message body and not into the URL.
To create the payment form you just need to add the following lines of HTML/JavaScript to your page and populate the following variables
The checkout'sid
which you received in the response from step 1.
The shopperResultUrl
, is the page on your site where the customer should be redirected to after the payment is processed as well as the brands which shall be available for this payment.
Once the payment has been processed, the customer is redirected to your shopperResultUrl
along with a GET parameter resourcePath
.
Important: The baseUrl must end in a "/", e.g. "https://test.oppwa.com/".
Then, to get the status of the payment, you do a GET request to the baseUrl + resourcePath
, including your authentication parameters.
Example of a resourcePath:
Important: A throttling rule applies for get payment status calls. Per checkout, it is allowed to send two get payment requests in a minute.
We recommend that you verify the following fields from the Payment Status response, by comparing the returned values with expected:
ID(s)
Amount
Currency
Brand
Type
A PA is created by sending a POST request over HTTPS to the /v1/checkouts resource. The request should include all required information such as your authentication credentials, the type of transaction, the amount, and the payment information such as card details. A capture may be sent against a successful PA to request the funds being sent for clearing. See for more details.
First, perform a Server-to-Server POST request to prepare the checkout with the required data, including the order type, amount, currency, and the . The response to a successful request is a JSON string containing a checkout'sid
, which is required in the second step to create the payment form.
For a full list of parameters which can be sent in the prepare checkout request, please see the
For a full list of parameters which can be sent in the prepare checkout request, please see the
For a full list of parameters which can be sent in the prepare checkout request, please see the .
View the for more information on customizing the payment form.
View the for more information on customizing the payment form.
First, perform a Server-to-Server POST request to prepare the checkout with the required data, including the order type, amount, currency and the . The response to a successful request is a JSON string containing a checkout'sid
, which is required in the second step to create the payment form.
For a full list of parameters which can be sent in the prepare checkout request, please see the
View the for more information on customizing the payment form.
COPYandPAY is used to securely accept the payment data. Once the payment data has been processed you can perform refunds or other backoffice operations by following our .