Bank Transfer Withdrawal (via CashServices)

Provider CashServices offers bank transfer withdrawal.

The following method IDs are covered in this section:

ID

Name

Credit/Debit State

24

BankTransferWithdrawal

WithdrawnByProvider

A file with specific file format will be generated with BankTransferWithdrawals payments and this file will be manually uploaded to provider's system. When the file is uploaded the provider is processing it within the bank. Then the provider will send email notification with an URL where can be downloaded a file with the statuses for each payment. The payments that are successfully processed will be moved to WithdrawnByProvider state and the payments that are not processed - in state RefusedByProvider.

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following table contains the fields to be sent in the initiatePaymentRequest. xml section:

key (value type, account type, required)

value

userID
(string, required)

The Sportingbet client ID. Must be numeric (no points or commas are allowed)

amount (string, required)

Withdrawal amount. Must be numeric (no decimal places are allowed for the chilean pesos)

The following table contains the fields to be sent in the initiatePaymentRequest.userData.xml section:

key (value type, account type, required)

value

identificationNumber
(string, required)

The user’s identification number. Must be 7 or 8 numbers followed by a hyphen (-) followed by a digit from 0 to 9 or a K

email (string)

The user’s email address

firstname (string)

The user´s first name

lastname (string)

The user´s last name

username (string)

The user’s username

The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentData.xml section:

key (value type, account type, required)

value

PaymentProviderID
(string, required)

The ID of the provider (157 for CashServices)

The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentAccountData.xml section:

key (value type, account type, required)

value

BankName
(string, required)

The name of the Bank, must be one of the following (according to the latest provider documentation as of 01.2018) :
Banco de Chile
Banco Estado
Banco Falabella
Banco Itau
Banco Ripley
Banco Security
BBVA
BCI
BCI Nova
Bice
Consorcio
Coopeuch
Credichile
Edwards Citi
HSBC Bank
Itau Corpbanca
Santander
Scotiabank

AccountNumber
(string, required)

The beneficiary account number.

BankCountryCode2
(string, required)

The two letter bank country code, e.g. CL

AccountOwnerAddress
(string, required)

The full address of the beneficiary account owner.

AccountType
(string, required)

The type of the account (tipo de cuenta) being credited. Must be one of the following:
Corriente
Vista
Rut
Ahorro

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>MyMerchantID</merchantID>
    <shopID>MyShopID</shopID>
    <merchantTransactionID>929ji5d4-2124-1111-1536-a7e6c224957e</merchantTransactionID>    
    <paymentMethodID>24</paymentMethodID>
    <amount currencyCode="CLP">10000</amount>                                              
    <userID>123456</userID>
    <userData>
        <username>bz_t1test2test3test4test5test6</username>
        <firstname>Marcos Ignacio</firstname>
        <lastname>Perez Guevara</lastname>
        <email>[email protected]</email>
        <identificationNumber>76149769-k</identificationNumber>
    </userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>0bde6d65-1c02-42c8-9a4f-149f2c5779fc</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyIntValuePair">
            <key>PaymentProviderID</key>
            <value>157</value>
        </data>
    </specificPaymentData>
    <paymentAccount>
        <specificPaymentAccountData>
            <data xsi:type="keyStringValuePair">                                                
                <key>BankName</key>
                <value>Banco De Chile</value>
            </data>
        <data xsi:type="keyStringValuePair">
            <key>AccountType</key>
            <value>Rut</value>
        </data>
            <data xsi:type="keyStringValuePair">                                               
                <key>AccountNumber</key>                                                
                <value>2258038807</value>
            </data>
            <data xsi:type="keyStringValuePair">                                               
                <key>BankCountryCode2</key>                                                
                <value>CL</value>
            </data>
            <data xsi:type="keyStringValuePair">
                <key>AccountOwnerAddress</key>                                                
                <value>pedro aguirre cerda 0256 depto 521 la cisterna san</value>
            </data>
        </specificPaymentAccountData>
    </paymentAccount>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>24</key>
            <value>BankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>929ji5d4-2124-1111-1536-a7e6c224957e</merchantTransactionID>
        <paymentID>a6a09edd-64fa-4a25-9d7d-3f2026812347</paymentID>
        <userID>123456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">10000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>90fc54e3-7fcc-4931-8c48-60bc711a392c</id>
            <definition>
                <key>240</key>
                <value>ToBeWithdrawnByProvider</value>
            </definition>
            <createdOn>2017-09-21T07:30:48.3975774Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">13.49</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>1590619</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>be5e1bdd-095f-466b-baba-7fb0c48a55db</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

Notifications

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

Upon uploading the file in provider’s system the user will be notified for payments that are successfully processed (state WithdrawnByProvider) or not being able to be processed (state RefusedByProvider).

State

Description

WithdrawnByProvider

Success state.

RefusedByProvider

Payment has been rejected by the provider.

Example handlePaymentStateChangedNotificationRequest:

<?xml version="1.0" encoding="utf-16"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>MyMerchantID</merchantID>
        <shopID>MyShopID</shopID>
        <paymentMethod>
            <key>24</key>
            <value>BankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>961ebed6-119d-490e-80c2-6d73a970e24d</merchantTransactionID>
        <paymentID>e95558a6-bca4-450c-af54-fb2deb807ef2</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>157</key>
            <value>CashServices</value>
        </paymentProvider>
        <amount currencyCode="CLP">1090.0000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>b27e0349-7a13-4e9d-8eb7-c9456202b2d0</id>
            <definition>
                <key>20</key>
                <value>WithdrawnByProvider</value>
            </definition>
            <createdOn>2018-01-31T08:45:14.153</createdOn>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseMessage</key>
          <value>reason</value>
        </detail>
        <detail xsi:type="keyIntValuePair">
          <key>PaymentStateReasonID</key>
          <value>1</value>
        </detail>
      </paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">1.4700</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>22463849</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>2258038807</paymentAccountID>
        </paymentAccount>
    </payment>
</handlePaymentStateChangedNotificationRequest>