Nuvei’s server-to-server REST API 2.0 integration method is now available.

What’s New in REST 2.0

• Improved infrastructure ​
• Developer-friendly authentication
• Up-to-date and compatible RESTful protocol​
• Simplified workflows
• New features and services support
• YAML files support

For complete information about the REST API 2.0 endpoints, requests, schemas, and parameters, see the API Reference 2.0 guide.

RESTful Structure

• Proper use of CRUD operations: POST for creation, PUT/PATCH for updates, and GET for retrieving information.
• The endpoint structure https://api.nuvei.com/payment-api/{object} is used for creation. For example, to create a payment using REST 2.0, send a POST request to https://api.nuvei.com/payment-api/payments.
• The POST structure https://api.nuvei.com/payment-api/{object}/{id}/{operation} is used to perform a specific operation on an existing endpoint. For example, to perform a refund on a payment transaction, send a POST request to https://api.nuvei.com /payment-api/payments/12312334/refund.

Payment Flow – 3D-Secure v2 Card

Handling Record IDs

• Each POST /payments request returns a paymentId. All subsequent transactions are linked to this paymentId.
• In the REST 2.0 flow, you do not need to provide all the parameters in each request in the same payment cycle. For example, if you want to refund a transaction, REST 2.0 only needs paymentId and the refund details: amount (if partial), currency, and so on.

Payment Methods

REST 2.0 supports:

• • 3D-Secure (3DS) card payments
  • Non-3D-Secure card payments
  • Apple Pay
  • Google Pay
  • Bank Transfer (ACH) APM