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.