Payment Gateway API

This document describes the Server to Server API which enables merchants and PSPs to integrate PayXpert payment solutions transparent and seamlessly. Prior to use you should have submitted an application and supporting documents to receive an originator ID and a password. All examples are using a generic originatorId and password that must be change prior to their execution.

Using the Server to Server API, the merchant transmits all the informations required to make the payment directly to PayXpert system via an HTTP request. The merchant is responsible for collecting and storing sensitive payment details of his customers. He must ensure the confidentiality and security of those details.

A separate account permits to access the backoffice where summary statistics, individual transactions details are available. Operation can also be manually done on transactions (like refunds, rebill…). The backoffice is available at: https://central.payxpert.com

For integration questions please email: support@payxpert.com .

General Information

The Payment Gateway API is based on the REST principle. In short the calls are manipulating (fetching, creating, deleting…) resources identified by URIs by applying a method (standard HTTP methods).

The strings in the URL between {} are dynamic parameters that must be replaced by the corresponding references (for example the transaction ID on which the call will act on).
The strings in the URL between () are optional parameters.

Authentication

The authentication during the API calls is using the standard HTTP basic authentication. The user and password to use are the originator ID and password provided at subscription.

Naming convention

The API uses the camelCase naming convention for parameter names as in cardSecurityCode. Acronyms and initials such as IP or ID remain in upper case as in customerIP, AVSPolicy or CAVV.

Data character encoding

Every data transmitted and received is encoded in UTF-8 character set.

Data Transmission Format

Requests

Requests towards the payment gateway consists in standard HTTP method with parameters.

In case of POST requests, the parameters must be transmitted in the body of the request as a JSON structure. In case of GET requests, the parameters are transmitted as standard parameters in the URL.

Responses

Every responses from the payment gateway consist in a JSON structure in the body of the response.

This is a sample of the output you will get in when calling a CCSale function:

{"transactionID":512345,"errorCode":"000","errorMessage":"Transaction successfully completed","statementDescriptor":"payxpert.net"}

Revisions

API revisions