Chapter 5 - XML Payments Integration

It is also possible to send XML directly to the Nuvei payment server. This is useful in a scenario where your application needs full control of the payment process or where you wish to collect account details on your site.

The XML XSD description for all of the packet types below is available there:

https://testpayments.nuvei.com/merchant/gateway.xsd

Note that all data sent to us should be correctly uncoded using UTF-8 as the character encoding.

Generated reference that should be stored for tracking and remote XML refunding.

RESPONSECODE

E:Initial Approval or D:Declined.

RESPONSETEXT

The text of the authorization.

APPROVALCODE

Original code provided by ACH JH as the authorization response.

DATETIME

The time of the transaction created by the bank. Format: YYYY-MM- DDTHH:MM:SS. Note that this is intentionally in a diferent format to the request timestamp to highlight the fact that it is a diferent time.

HASH

An SHA-512 HASH. See Note 2 below.

Notes:

1. The request SHA-512 HASH is generated using the following as an input string:

Many code examples on how to generate an SHA-512 HASH can be found in the Internet. For assistance, please contact Nuvei.

3. In case you desire to inform your customer's email and desire to provide his/ her receipt in another language, you can use the Accept-Language parameter of the request to set language the customer should receive the receipt in. If the language informed is not supported, the Payment Gateway will use its default language (EN). Possible values are 'fr-FR' or even 'fr,en-US;q=0.9,en;q=0.8,ru;q=0.7,de;q=0.6,ru-RU;q=0.5,de-DE;q=0.4'.

Error handling

If there is an error processing the transaction, the error string is returned in an XML message with the simple:

3. In case you desire to inform your customer’s email to provide his/ her receipt in another language, you can use the Accept-Language parameter of the request to set language the customer should receive the receipt in. If the language informed is not supported, the Payment Gateway will use its default language (EN). Possible values are 'fr-FR' or even
'fr,en-US;q=0.9,en;q=0.8,ru;q=0.7,de;q=0.6,ru-RU;q=0.5,de-DE;q=0.4'.

Need Help?

How can we help you today? Our team is standing by and just a click away.