On this page:
Sections
The following sections detail the contents of the POSTs and responses, between your server and ours. The format and size of each field is given, along with accepted values and characters.
- Transaction Registration POST
- Response to the Transaction Registration
- Response to transaction registration POST (Status=3DAUTH)
- 3D-Authentication Results POST from your Terminal URL
- Response to Transaction Registration POST (Status=PPREDIRECT)
- Callback after PayPal Authentication
- Complete a PayPal Transaction
Overview
All transactions are synchronous HTTPS POSTs sent from a script on your servers to the Opayo gateway. The same script reads the Response component of the POST to determine success or failure.
POSTs can be sent using any HTTPS compatible objects including:
- cURL in PHP
- HttpWebRequest in.NET
- Apache HttpComponents in Java
Data is sent as URL Encoded Name=Value pairs separated with ampersand (&) characters and sent to the Opayo Server URL with a Service name set to the message type in question.
Character and String Validation
The format and length of each field is detailed with example strings, values, and the valid characters listed in the following table.
Characters
Characters |
Description |
---|---|
0 to 9 |
|
0 to 99 |
|
Uppercase A to Z |
|
Mixed case A to z |
|
á |
|
@ |
|
# |
|
$ |
|
^ |
|
& |
|
* |
|
( ) |
|
_ |
|
- |
|
+ |
|
= |
|
{ } |
|
[ ] |
|
: |
|
; |
|
" |
|
| |
|
/ \ |
|
~ |
|
, |
|
. |
|
? |
|
! |
|
|
|
CRLF |
|
Strings
Value |
Description |
---|---|
BASE64 |
Valid Base64 characters including letters, digits, plus and forward slash |
BOOLEAN |
|
HTML |
Valid HTML with no active content. Script will be filtered. Includes all valid letters, numbers, punctuation and accented characters |
ISO639 |
ISO 639-2 (2-letter language codes) |
ISO3166 |
ISO 3166-1 (2-letter country codes) |
ISO4217 |
ISO 4217 (3-letter currency codes) |
RFC1738 |
RFC 1738 compliant HTTP(S) URL. Non-compliant characters should be URL encoded. For example spaces encode to %20. |
RFC532N |
RFC 5321/5322 (see also RFC 3696). Compliant email addresses. |
US |
Valid 2-letter US States |