GamersCard Withdrawal

The following method IDs are covered in this section:

ID	Name	Credit/Debit State
366	GamersCardWithdrawal	WithdrawnByProvider (20)

Payment method interaction type: Synchronous execution (see Interaction Types).

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following parameters can be provided in initiatePaymentRequest.specificPaymentData:

key (value type, requiredtype, required)	value
PaymentProviderID (Int, required)	Should be 188.

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
	<merchantID>B2BTestMerchant</merchantID>
	<shopID>150001</shopID>
	<merchantTransactionID>1e4d67e9-c154-4026-a902-d2c763f595f4</merchantTransactionID>
	<paymentMethodID>366</paymentMethodID>
	<amount currencyCode="USD">99.99</amount>
	<userID>bc1544de-7443-45f6-976e-d253e5</userID>
	<userData>
		<username>bc1544de-7443-45f6-976e-d253e5</username>
		<firstname xsi:nil="true" />
		<lastname xsi:nil="true" />
		<currencyCode xsi:nil="true" />
		<languageCode xsi:nil="true" />
		<email xsi:nil="true" />
		<address xsi:nil="true" />
		<identificationNumberType xsi:nil="true" />
		<drivingLicenseNumber xsi:nil="true" />
		<drivingLicenseIssuingState xsi:nil="true" />
	</userData>
	<userIP>127.0.0.1</userIP>
	<userSessionID>12ec4f9d-2cf6-4ed7-a71d-0a7eda90c7bf</userSessionID>
	<creationTypeID>1</creationTypeID>
	<specificPaymentData>
		<data xsi:type="keyIntValuePair">
			<key>PaymentProviderID</key>
			<value>188</value>
		</data>
	</specificPaymentData>
	<paymentAccountID>cab55452-94c2-4034-8234-27184c12a37c</paymentAccountID>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
	<payment xsi:type="paymentWithPaymentAccount">
		<merchantID>B2BTestMerchant</merchantID>
		<shopID>150001</shopID>
		<paymentMethod>
			<key>366</key>
			<value>GamersCardWithdrawal</value>
		</paymentMethod>
		<merchantTransactionID>1e4d67e9-c154-4026-a902-d2c763f595f4</merchantTransactionID>
		<paymentID>4db6af22-0753-4767-9bfd-a20db7a2f98e</paymentID>
		<userID>bc1544de-7443-45f6-976e-d253e5</userID>
		<paymentProvider>
			<key>188</key>
			<value>CREDTA</value>
		</paymentProvider>
		<amount currencyCode="USD">99.99</amount>
		<creationType>
			<key>1</key>
			<value>User</value>
		</creationType>
		<userIP>127.0.0.1</userIP>
		<state>
			<id>af2f762e-322e-478e-ac9d-3e845a4d0e94</id>
			<definition>
				<key>20</key>
				<value>WithdrawnByProvider</value>
			</definition>
			<createdOn>2020-04-28T13:01:19.803864Z</createdOn>
			<paymentStateDetails xsi:nil="true" />
		</state>
		<isExecuted>true</isExecuted>
		<baseAmount currencyCode="EUR">75.13</baseAmount>
		<paymentDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderTransactionID</key>
				<value>932139321</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>LocalCurrency</key>
				<value>BRL</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>LocalAmount</key>
				<value>81.14</value>
			</detail>
			<detail xsi:type="keyDecimalValuePair">
				<key>FeePercentage</key>
				<value>21</value>
			</detail>
			<detail xsi:type="keyDecimalValuePair">
				<key>ProviderFee</key>
				<value>68.61</value>
			</detail>
			<detail xsi:type="keyDecimalValuePair">
				<key>PaymentCurrencyToLocalCurrencyConversionRate</key>
				<value>12.28</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderExternalID</key>
				<value>31752974</value>
			</detail>
		</paymentDetails>
		<paymentAccount>
			<paymentAccountID>cab55452-94c2-4034-8234-27184c12a37c</paymentAccountID>
			<details>
				<detail xsi:type="keyStringValuePair">
					<key>MaskedNumber</key>
					<value>************0114</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>AccountOwnerToken</key>
					<value>1775b38f-2b3a-4ccf-9238-029027af6944</value>
				</detail>
				<detail xsi:type="keyIntValuePair">
					<key>ExpiryMonth</key>
					<value>5</value>
				</detail>
				<detail xsi:type="keyIntValuePair">
					<key>ExpiryYear</key>
					<value>2027</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>HolderName</key>
					<value>Tsani Prodanov</value>
				</detail>
				<detail xsi:type="keyStringValuePair">
					<key>CardType</key>
					<value>MastercardDebit</value>
				</detail>
			</details>
		</paymentAccount>
	</payment>
</initiatePaymentResponse>

Following field is returned in paymentDetails of initiatePaymentResponse:

Field name	Description
ProviderTransactionID	GamersCard`s unique transactionID.

Notifications

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

The final execution status has the following payment states:

Payment States	Description
RefusedByProvider (100)	Error state; payment was not accepted by provider. See section RefusedByProvider Error Codes.
WithdrawnByProvider (20)	Success state; payment has been executed.
WithdrawCommunicationErrorOccurred (576)	Error state; payment request was incorrect or provider was unreachable.

RefusedByProvider Error Codes

ProviderResponseCode	ProviderResponseMessage
E1000	NOT AUTHORIZED - The user has insufficient funds for completing the transaction.
E1001	CASH-OUT LIMIT EXCEEDED - Deposit limit its exceeded.
E1002	CASH-IN LIMIT EXCEEDED - Our withdrawal limit its exceeded.
E1003	ALREADY CHARGED BACK
E1004	INSUFICIENT FUNDS FOR CHARGEBACK
E2000	PARTNER NOT AUTHORIZED - The user has blocked your transactions intentionally.
E2001	CARD BLOCKED
E2002	CARD NOT ACTIVATED - The user has a brand new card an has not activated it.
E2003	INVALID CARD OR CREDENTIALS DATA - The user has provided the wrong card or credential details (ex: PAN, CVV, password)
E2004	UNSUPPORTED CURRENCY
E2005	CUSTOMER NOT FOUND - The user has provided a PAN that does not belong to GamersCard BIN.
E3000	QUERY PERIOD EXCEEDED - The period asked in the query for Transcations is too long.
E3001	MISSING / WRONG DATA OR PARAMETERS TO COMPLETE OPERATION - Bad request format is being sent.
E3003	UNABLE TO COMPLETE OPERATION, TRY AGAIN LATER - Temporary state where we could not complete the operation (networking or processing problems in general).
E3004	PARTNER TRANSACTION ID ALREADY USED - Signals to partner that the desired partnerId has already been used.