Payment Initialization
The first step of the Ratepay payment workflow is the PAYMENT_INIT.
This operation is called to initialize the Ratepay transaction and obtain a valid transaction ID. The transaction ID must be passed with every subsequent Gateway request related to the same Ratepay transaction.
Request Parameters
<head>
Section
Parameter | Condition | Enumeration |
---|---|---|
system-id |
Mandatory | |
operation |
Mandatory | PAYMENT_INIT |
credential |
Mandatory |
The PAYMENT_INIT request do not contain a <content>
section.
XML Example
<?xml version="1.0" encoding="UTF-8"?>
<request version="1.0" xmlns="urn://www.ratepay.com/payment/1_0">
<head>
<system-id>myshop</system-id>
<operation>PAYMENT_INIT</operation>
<credential>
<profile-id>INTEGRATION_TE_DACH</profile-id>
<securitycode>4c0a11923fa3433fb168f9c7176429e9</securitycode>
</credential>
</head>
</request>
Response Parameters
<head>
Section
Parameter | Condition | Enumeration |
---|---|---|
system-id |
Mandatory | |
transaction-id |
Mandatory | |
operation |
Mandatory | PAYMENT_INIT |
response-type |
Mandatory | - success: STATUS_RESPONSE - failure: STATUS_ERROR |
processing |
Mandatory |
The PAYMENT_INIT response do not contain a <content>
section.
XML Example
<response xmlns="urn://www.ratepay.com/payment/1_0" version="1.0">
<head>
<system-id>MyTestsystem</system-id>
<transaction-id>xx-xxxxxxxxxxxxxx</transaction-id> <!-- unique identifier for this transaction -->
<transaction-short-id>3EQP.SBYM.CBSR.3302</transaction-short-id>
<operation>PAYMENT_INIT</operation>
<response-type>STATUS_RESPONSE</response-type>
<external />
<processing>
<timestamp>2016-01-06T16:56:19.000</timestamp>
<status code="OK">Successfully</status>
<reason code="300">Processing successful</reason>
<result code="350">Transaction initialized</result>
</processing>
</head>
</response>