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

Copy
Copied
<?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

Copy
Copied
<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>