Bancontact/Mister Cash Deposit (via Smart2Pay)

Payment Method Bancontact, formerly known as Mister Cash till April 2016, is the market leader in electronic payments in Belgium.

The following method IDs are covered in this section:

IDNameCredit/Debit StateReversal State
112MisterCashDepositDepositedByProvider (13)

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

Redirect Integration

Supported.

Backend2BackendIntegration

The URL for Success, Error, Pending and Cancel can be provided in initiatePaymentRequest.specificPaymentData as the provider also sends notification for all these states to PXP Financial, and PXP Financial notifies the merchant accordingly.

key (value type, account type, required)value
SuccessPageUrl
(string)
URL of the merchant´s success page
ErrorPageUrl (string)URL of the merchant´s error page
PendingPageUrl (string)URL of the merchant's pending page
CancelPageUrl (string)URL of the merchant´s cancel page

Example initiatePaymentRequest:

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<merchantID>YourMerchantID</merchantID>
	<shopID>YourShopID</shopID>
	<merchantTransactionID>0e23b2f1-1d92-4ddd-8d43-9de4e77e279b</merchantTransactionID>
	<paymentMethodID>112</paymentMethodID>
	<amount currencyCode="EUR">100</amount>
	<userID>d48693ca-e96e-4ca1-9e01-035645a79399</userID>
	<userData></userData>
	<userIP>127.0.0.1</userIP>
	<userSessionID>6a956eae-d903-4a01-8170-20dae92673d1</userSessionID>
	<creationTypeID>1</creationTypeID>
	<specificPaymentData>
		<data xsi:type="keyStringValuePair">
			<key>SuccessPageUrl</key>
			<value>http://successpage.url</value>
		</data>
		<data xsi:type="keyStringValuePair">
			<key>ErrorPageUrl</key>
			<value>http://errorpage.url</value>
		</data>
		<data xsi:type="keyStringValuePair">
			<key>PendingPageUrl</key>
			<value>http://pendingpage.url</value>
		</data>
		<data xsi:type="keyStringValuePair">
			<key>CancelPageUrl</key>
			<value>http://cancelpage.url</value>
		</data>
		<data xsi:type="keyStringValuePair">
			<key>HomePageUrl</key>
			<value>http://homepage.url</value>
		</data>
	</specificPaymentData>	
</initiatePaymentRequest>

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
			<payment>
				<merchantID>YourMerchantID</merchantID>
				<shopID>YourShopID</shopID>
				<paymentMethod>
					<key>112</key>
					<value>Smart2PayMisterCashDeposit </value>
				</paymentMethod>
				<merchantTransactionID>0e23b2f1-1d92-4ddd-8d43-9de4e77e279b</merchantTransactionID>
				<paymentID>8817319c-535f-4a95-a1ef-d41adddc23cd</paymentID>
				<userID>d48693ca-e96e-4ca1-9e01-035645a79399</userID>
				<paymentProvider>
					<key>41</key>
					<value>Smart2Pay</value>
				</paymentProvider>
				<amount currencyCode="EUR">100</amount>
				<creationType>
					<key>1</key>
					<value>User</value>
				</creationType>
				<userIP>127.0.0.1</userIP>
				<state>
					<id>a9c94001-0e2b-4c7f-9c02-99a59a069b9c</id>
					<definition>
						<key>287</key>
						<value>RedirectDataCreated</value>
					</definition>
					<createdOn>2011-05-02T14:50:39.7811376Z</createdOn>
					<description>https://europay.smart2pay.com/Landing.aspx?TRXID=c1ae3774-6bbc-4931-9269-21cc2fc292b0</description>
					<paymentStateDetails>
						<detail xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
							<key>RedirectionUrl</key>
							<value>https://europay.smart2pay.com/Landing.aspx?TRXID=c1ae3774-6bbc-4931-9269-21cc2fc292b0</value>
						</detail>
						<detail xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
							<key>PostDataencINFO</key>
							<value>
5609FF5C2A7060F2F16EC1F6FE037A85</value>
						</detail>
						<detail xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
							<key>PostDataKeys</key>
							<value>encINFO</value>
						</detail>
					</paymentStateDetails>
				</state>
				<isExecuted>false</isExecuted>
				<baseAmount currencyCode="EUR">100</baseAmount>
				<paymentDetails xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"></paymentDetails>
			</payment>
		</initiatePaymentResponse>

Possible payment states in initiatePaymentResponse:

Payment StatesDescription
RedirectDataCreated (287)OK state; Redirect user to the URL
ProviderCommunicationErrorOccurred (233)Error state; Communication error during payment finalization
InitiateErrorReportedByProvider (4)Error state; Technical error during payment initialization. See below table for list of error codes.
InitiateRequestProviderCommunicationErrorOccurred (325)Error state; Technical error during payment initialization
BlockedByPaymentScoring (202)Error state; Refused by the PXP Financial Risk System
RefusedByPaymentScoring (121)Error state; Refused by the PXP Financial Risk System

Provider specific error codes:

ErrorCodeErrorMessage
MR0001Xml invalid format
EP0002 Xml is not well formed
EP0003 Invalid format for Merchant ID
EP0004 Merchant ID does not exist
EP0005 Transaction cannot be processed at this moment
EP0006 Merchant is locked
MR0007 Transaction cannot be created
EP0008 This payment method is not supported at this time
EP0009 Invalid Transaction ID
MR0010 Cannot return transaction status
EP0011 Invalid country code
EP0012 Request is not allowed
EP0013 Merchant is locked for this method. Please contact our technical department

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:

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest 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>KalixaAcceptDEMO</merchantID>
		<shopID>KalixaAcceptDEMO</shopID>
		<paymentMethod>
			<key>112</key>
			<value>MisterCashDeposit</value>
		</paymentMethod>
		<merchantTransactionID>20141216_5</merchantTransactionID>
		<paymentID>d76c3f8e-5a6d-47bb-ab3f-2b5a76c03245</paymentID>
		<userID>KalxiaTestUser_7</userID>
		<paymentProvider>
			<key>41</key>
			<value>Smart2Pay</value>
		</paymentProvider>
		<amount currencyCode="EUR">100.0000</amount>
		<creationType>
			<key>1</key>
			<value>User</value>
		</creationType>
		<userIP>195.72.132.1</userIP>
		<state>
			<id>ef767ec8-a0f3-4f0f-afa0-78448d38c6e9</id>
			<definition>
				<key>29</key>
				<value>DepositedByProvider</value>
			</definition>
			<createdOn>2014-12-16T13:00:57.793</createdOn>
			<paymentStateDetails xsi:nil="true" />
		</state>
		<isExecuted>true</isExecuted>
		<baseAmount currencyCode="EUR">100.0000</baseAmount>
		<paymentDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderExternalID</key>
				<value>714232</value>
			</detail>
			<detail xsi:type="keyIntValuePair">
				<key>PaymentScoring</key>
				<value>714232</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderTransactionID</key>
				<value>fe409bf7-33e3-49ad-b739-858ae92e2e46</value>
			</detail>
		</paymentDetails>
		<paymentAccount>
			<paymentAccountID>0</paymentAccountID>
		</paymentAccount>
	</payment>
</handlePaymentStateChangedNotificationRequest>