Platba24 Deposit (Česká spořitelna)

Platba24 is the online banking payment method from bank Ceska sporitelna.

The following method IDs are covered in this section:

ID	Name	Credit/Debit State	Reversal State
222	Platba24Deposit	DepositedByProvider (29)

Payment method interaction type: Redirection to External Payment Provider (see Interaction Types).

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following parameters can be provided in initiatePaymentRequest.specificPaymentData:

key (value type, account type, required)	value
MerchantNotificationUrl (string, required)	The URL where the user will be redirected after payment execution with payment execution result. NOTE: Url can’t contain query string parameters. Provider supports only URLs without parameters!
PaymentDescription (string)	Description of the payment. NOTE: This parameter is not transferred to the provider.

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest>
  <merchantID>KalixaAcceptDemo</merchantID>
  <shopID>KalixaAcceptDemo</shopID>
  <merchantTransactionID>test_13_9991</merchantTransactionID>
  <paymentMethodID>222</paymentMethodID>
  <amount currencyCode="CZK">10</amount>
  <userID>d48693ca-e96e-4ca1-9e01-035645a79399</userID>
  <userData/>
  <userIP>127.0.0.1</userIP>
  <userSessionID>6a956eae-d903-4a01-8170-20dae92673d1</userSessionID>
  <creationTypeID>1</creationTypeID>
  <specificPaymentData>
    <data xsi:type="keyStringValuePair">
      <key>MerchantNotificationURL</key>
      <value>http://successpage.url</value>
    </data>
    <data xsi:type="keyStringValuePair">
      <key>PaymentDescription</key>
      <value>test</value>
    </data>
  </specificPaymentData>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <merchantID>KalixaAcceptDemo</merchantID>
    <shopID>KalixaAcceptDemo</shopID>
    <paymentMethod>
      <key>222</key>
      <value>Platba24Deposit</value>
    </paymentMethod>
    <merchantTransactionID>test_13_9991</merchantTransactionID>
    <paymentID>a2540e6b-4e76-437b-ae16-965e01a556b6</paymentID>
    <userID>d48693ca-e96e-4ca1-9e01-035645a79399</userID>
    <paymentProvider>
      <key>149</key>
      <value>CeskaSporitelna</value>
    </paymentProvider>
    <amount currencyCode="CZK">10</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>2b52d1f6-7e12-4e75-96fb-b9c3285f0517</id>
      <definition>
        <key>30</key>
        <value>RedirectURLCreated</value>
      </definition>
      <createdOn>2017-05-03T12:44:42.6554932Z</createdOn>
      <description>https://api.test.kalixa.com/WebMockProviders/CeskaSporitelnaFrontend/Platba24?shopid=110776&amp;amount=10.00&amp;varsymbol=8&amp;specsymbol=8&amp;url=http://successpage.url&amp;sign=b0a9ffd3b06dc7166614a38840cf47eb6c67dec057f1403e7be55f0b4bb1df61</description>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>RedirectionUrl</key>
          <value>https://api.test.kalixa.com/WebMockProviders/CeskaSporitelnaFrontend/Platba24?shopid=110776&amp;amount=10.00&amp;varsymbol=8&amp;specsymbol=8&amp;url=http://successpage.url&amp;sign=b0a9ffd3b06dc7166614a38840cf47eb6c67dec057f1403e7be55f0b4bb1df61</value>
        </detail>
        <detail xsi:type="keyStringValuePair">
          <key>PaymentStateReasonID</key>
          <value>1</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>false</isExecuted>
    <baseAmount currencyCode="EUR">0.38</baseAmount>
    <paymentDetails xsi:nil="true"/>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</initiatePaymentResponse>

*Example handleProviderNotificationToMerchantRequest:

<?xml version="1.0" encoding="utf-8"?>
<handleProviderNotificationToMerchantRequest  
    xmlns="http://www.cqrpayments.com/PaymentProcessing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <merchantID>KalixaAcceptDemo</merchantID>
  <providerID>149</providerID>
  <queryString>shopid=110776&amp;amount=10.00&amp;varsymbol=8&amp;specsymbol=8&amp;completed=Y&amp;sign=191a5131f9c22234f5cf1cf0cd811194976d259d90c66a5383224f1a99acd579</queryString>
  <content></content>
</handleProviderNotificationToMerchantRequest>

*Example handleProviderNotificationToMerchantResponse: (successful payment)

<?xml version="1.0" encoding="utf-8"?>
<handleProviderNotificationToMerchantResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <merchantID>KalixaAcceptDemo</merchantID>
    <shopID>KalixaAcceptDemo</shopID>
    <paymentMethod>
      <key>222</key>
      <value>Platba24Deposit</value>
    </paymentMethod>
    <merchantTransactionID>test_13_9991</merchantTransactionID>
    <paymentID>a2540e6b-4e76-437b-ae16-965e01a556b6</paymentID>
    <userID>d48693ca-e96e-4ca1-9e01-035645a79399</userID>
    <paymentProvider>
      <key>149</key>
      <value>CeskaSporitelna</value>
    </paymentProvider>
    <amount currencyCode="CZK">10.0000</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>eab02a25-4ce9-484a-8f74-5405a18255d6</id>
      <definition>
        <key>29</key>
        <value>DepositedByProvider</value>
      </definition>
      <createdOn>2017-05-03T12:47:10.2923746Z</createdOn>
      <description>Completed:'Y'</description>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderStatusCode</key>
          <value>Y</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>true</isExecuted>
    <baseAmount currencyCode="EUR">0.3800</baseAmount>
    <paymentDetails xsi:nil="true"/>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</handleProviderNotificationToMerchantResponse>

*Example handleProviderNotificationToMerchantResponse: (unsuccessful payment)

<?xml version="1.0" encoding="utf-8"?>
<handleProviderNotificationToMerchantResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <merchantID>KalixaAcceptDemo</merchantID>
    <shopID>KalixaAcceptDemo</shopID>
    <paymentMethod>
      <key>222</key>
      <value>Platba24Deposit</value>
    </paymentMethod>
    <merchantTransactionID>test_13_9992</merchantTransactionID>
    <paymentID>155516a9-7c4d-44b7-9569-b533280cfff2</paymentID>
    <userID>d48693ca-e96e-4ca1-9e01-035645a79399</userID>
    <paymentProvider>
      <key>149</key>
      <value>CeskaSporitelna</value>
    </paymentProvider>
    <amount currencyCode="CZK">10.0000</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>fbe6c3a2-fbf4-41f7-8876-f998eda3ae50</id>
      <definition>
        <key>101</key>
        <value>AbortedByCustomer</value>
      </definition>
      <createdOn>2017-05-03T13:05:18.3101349Z</createdOn>
      <description>Completed:'N'</description>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderStatusCode</key>
          <value>N</value>
        </detail>
        <detail xsi:type="keyStringValuePair">
          <key>PaymentStateReasonID</key>
          <value>1</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>false</isExecuted>
    <baseAmount currencyCode="EUR">0.3800</baseAmount>
    <paymentDetails xsi:nil="true"/>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</handleProviderNotificationToMerchantResponse>

Notifications

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

Example handlePaymentStateChangedNotificationRequest:

Example handlePaymentStateChangedNotificationResponse: