- Parameters for HASH calculation
- Example for HASH calculation
The data transfer is processed directly via an HTTPS-POST or HTTPS-GET request by the browser of the customer.
The data is returned in JSON data format or as parameter in an HTTP redirect.
The requests must be sent to the following URL:
Client API URL: https://secure.pay1.de/client-api/
The following parameters are mandatory for each request:
| request
required
|
Format LIST
|
|||||||||||||||
| mid
required
|
Format NUMERIC(5..6)
Merchant ID, defined by PAYONE |
|||||||||||||||
| aid
required
|
Your subaccount ID, 5-digit numeric
|
|||||||||||||||
| portalId
required
|
Format NUMERIC(7)
Portal ID, defined by PAYONE |
|||||||||||||||
| mode required
|
Format LIST
Mode for transactions, either ‘live’ or ‘test’ |
|||||||||||||||
| encoding optional
|
Format LIST
The type of character encoding used in the request. |
|||||||||||||||
| responsetype required
|
Format LIST
- JSON - REDIRECT |
|||||||||||||||
| hash required
|
Format CHAR(1..96) lowercase
Permitted Symbols [0-9,a-z]
The hash code is used to prevent that a customer changes any relevant value (like payment type, your MID or the amount). |
|||||||||||||||
| successurl optional
|
Format CHAR(2..255) Scheme <scheme>://<host>/<path>> <scheme>://<host>/<path>?<query> scheme-pattern: [a-zA-Z]{1}[a-zA-Z0-9]{1,9} URL for "payment successful" |
|||||||||||||||
| errorurl optional
|
Format CHAR(2..255) Scheme <scheme>://<host>/<path> <scheme>://<host>/<path>?<query> scheme-pattern: [a-zA-Z]{1}[a-zA-Z0-9]{1,9} URL for "faulty payment" |
|||||||||||||||
| api_version required
|
Format LIST
|
|
to be PCI DSS SAQ_A compliant please use hosted iFrame |
In AJAX mode, values entered in a form can be checked and processed directly without reloading the web page. |
|
The client API forwards the user to a specific page after processing the from input. It itself doesn't have any output. |
Payment Requests |
Administration-Requests |
|
Verification / Scoring Requests |