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>