GamersCard Withdrawal

The following method IDs are covered in this section:

IDNameCredit/Debit State
366GamersCardWithdrawalWithdrawnByProvider (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 nameDescription
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 StatesDescription
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

ProviderResponseCodeProviderResponseMessage
E1000NOT AUTHORIZED - The user has insufficient funds for completing the transaction.
E1001CASH-OUT LIMIT EXCEEDED - Deposit limit its exceeded.
E1002CASH-IN LIMIT EXCEEDED - Our withdrawal limit its exceeded.
E1003ALREADY CHARGED BACK
E1004INSUFICIENT FUNDS FOR CHARGEBACK
E2000PARTNER NOT AUTHORIZED - The user has blocked your transactions intentionally.
E2001CARD BLOCKED
E2002CARD NOT ACTIVATED - The user has a brand new card an has not activated it.
E2003INVALID CARD OR CREDENTIALS DATA - The user has provided the wrong card or credential details (ex: PAN, CVV, password)
E2004UNSUPPORTED CURRENCY
E2005CUSTOMER NOT FOUND - The user has provided a PAN that does not belong to GamersCard BIN.
E3000QUERY PERIOD EXCEEDED - The period asked in the query for Transcations is too long.
E3001MISSING / WRONG DATA OR PARAMETERS TO COMPLETE OPERATION - Bad request format is being sent.
E3003UNABLE TO COMPLETE OPERATION, TRY AGAIN LATER - Temporary state where we could not complete the operation (networking or processing problems in general).
E3004PARTNER TRANSACTION ID ALREADY USED - Signals to partner that the desired partnerId has already been used.