Checkout Page

UNIPaaS checkout page allows merchants to accept digital payments on any device or channel.

By using the checkout page you reduce the effort involved in PCI compliance, which is required from merchants handling sensitive credit card information. The checkout page fully supports Strong Customer Authentication (3DSecure 2). Please follow this step-by-step guide for quick integration.

Checkout object properties

ParameterTypeDescriptionRequired
amountNumberThe Amount of the paymentYes
currencyStringThe Currency of the paymentYes
orderIdStringUnique ID from the merchant systemYes
emailStringThe buyer's email addressYes
countryStringThe buyer's country code. ISO 2 lettersYes
itemArray of ObjectsUsed to split payments between multiple vendors or a vendor and the platform.Yes
successfulPaymentRedirectStringA url to redirect the user after a successful checkout.
Example : https://mywebsite.com/success
No

The item object (for splitting payments)

The items Object is part of the Checkout Object and describes the order item details per vendor. In this Object you can set the platform fee per vendor.

FieldDescription
nameA description of the item
amountThe amount of the specific item.

_Please note that the itemAmount field you are asked to send to UNIPaaS via this API call needs to be the final item's amount - taking in consideration both line and subtotal discounts.

For example: if a buyer uses a coupon and receives a 20GBP discount - we will ask you to send us a new post-discount amount for each item.

Numeric example:
Item 1 - 100 
item 2 - 100 
Subtotal - 200

Discount - 20
Total - 180 

You need to send:
For item 1 - 90
For item 2 - 90_

The itemAmount total value must be equal to the Amount value (the total amount) sent in the Authorization Object
vendorIdThe unique Id of the vendor provided by UNIPaaS during vendor Onboarding
platformFeeThe fee percentage for a specific item

Open the link from your website

Redirect your buyers to the hosted checkout page

Verify the Authorization status from your server side

When checkout is done and user is redirected to the successfulPaymentRedirect URL, the following parameters will appearAs a parameter in the URL and should be used for verification:

  • Authorization ID
  • Order ID
  • Reference ID

Authorization verification is essential to ensure no manipulation occurred on the client-side.
Make a GET /pay-ins/{authorizationId} request:

curl --location --request GET 'https://sandbox.unipaas.com/platform/pay-ins/{authorizationId}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer --PRIVATE_KEY--'

Authorization status must be CAPTURED for a successful Authorization.
Check the Authorization statuses options for more information.

📘

Please note: If you send a transaction without any vendor ID - the transaction will be entered to the platform's account and will be listed as a platform transaction.


Deactivate checkout page

You can deactivate the checkout page that is set for online payment methods such as cards, instant bank transfers, or alternative payment methods (APMs). The deactivation feature is unavailable for checkouts set to offline payment methods like Direct Debit.

📘

Please note: This action is irreversible, and once checkout page is deactivated, it will not be possible to reactivate it again.

To deactivate your checkout page and make it unavailable, use the following endpoint:

POST /pay-ins/checkout/{signedLinkId}/expire

The request should not include a body.

Possible response:

Status CodeDescriptionResponse
200OKThe checkout object
401 Not Authorized
404Not Found"Checkout does not exist"
405Not Allowed"Checkout expired and can not be edited" - in case you are trying to deactivate an expired checkout.

Or

"This checkout is for offline payment method. Can not be expired" - in case you're trying to deactivate a checkout that is set to Direct Debit (which is offline payment method).

Test your integration

Use our test scenarios test your integration