GamersCard Deposit

The following method IDs are covered in this section:

ID

Name

Credit/Debit State

367

GamersCardDeposit

DepositedByProvider (29)

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

Redirect Integration

Currently not supported.

Backend2BackendIntegration - GamersCard Balance Enquiry

For the GamersCard balance enquiry getPaymentInputData is called by the merchant.

The following table contains the fields to be sent in the getPaymentInputData.Details xml section:

key (value type, required)

value

PaymentAccountID (string, required)

The unique id of the payment account in PS

Example getPaymentInputData:

<getPaymentInputDataRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <merchantID>B2BTestMerchant</merchantID>
    <shopID>ProviderTesting</shopID>
    <user>
        <id>77bd959a-380c-4874-afc6-2a7ce6</id>
    </user>
    <paymentMethodID>367</paymentMethodID>
    <details>
        <data xsi:type="keyStringValuePair">
            <key>PaymentAccountID</key>
            <value>5b9688a5-cb2a-4cad-9cc8-ad0fe44b7b98</value>
        </data>
    </details>
</getPaymentInputDataRequest>

Example of successful getPaymentInputDataResponse:

<getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <paymentInputData>
        <data xsi:type="keyStringValuePair">
            <key>Currency</key>
            <value>USD</value>
        </data>
        <data xsi:type="keyDecimalValuePair">
            <key>Amount</key>
            <value>1311025.79</value>
        </data>
    </paymentInputData>
</getPaymentInputDataResponse>

Example of an execution error reported by the provider in getPaymentInputDataResponse:

<getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <paymentInputData>
        <data xsi:type="keyStringValuePair">
            <key>ErrorCode</key>
            <value>E2005</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>ErrorMessage</key>
            <value>CUSTOMER NOT FOUND</value>
        </data>
    </paymentInputData>
</getPaymentInputDataResponse>

Example of a communication error reported by the provider in getPaymentInputDataResponse:

<getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <paymentInputData>
        <data xsi:type="keyStringValuePair">
            <key>ErrorCode</key>
            <value>400</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>ErrorMessage</key>
            <value>Communication error with provider!</value>
        </data>
    </paymentInputData>
</getPaymentInputDataResponse>

Example of no response received by the provider in getPaymentInputDataResponse:

<getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <paymentInputData>
        <data xsi:type="keyStringValuePair">
            <key>ErrorMessage</key>
            <value>No response received from the provider.</value>
        </data>
    </paymentInputData>
</getPaymentInputDataResponse>

Backend2BackendIntegration

The following parameters can be provided in initiatePaymentRequest.specificPaymentData:

key (value type, requiredtype, required)

value

PayerPassword
(String, required)

The player's password for their GamersCard account.

PaymentDescription (string, required)

Description of payment: short description.

PaymentDescriptionLanguageCode (string, required)

Language code of the payment description.

Example initiatePaymentRequest for a user's initial deposit. A new payment account is created in this case:

<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>B2BTestMerchant</merchantID>
    <shopID>ProviderTesting</shopID>
    <merchantTransactionID>e-4242-22225</merchantTransactionID>
    <paymentMethodID>367</paymentMethodID>
    <amount currencyCode="USD">10.05</amount>
    <userID>bc1544de-7443-45f6-976e-ge</userID>
    <userData></userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>44412fac-ec9d-44de-b511-5a5cc00ada80</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>PayerPassword</key>
         <value>PS1234</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescription</key>
            <value>Description of payment: short description</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescriptionLanguageCode</key>
            <value>en</value>
        </data>
    </specificPaymentData>
    <paymentAccount>
        <specificPaymentAccountData>
          <data xsi:type="keyStringValuePair">
            <key>CardNumber</key>
            <value>5292050400000114</value>
          </data>
          <data xsi:type="keyStringValuePair">
            <key>HolderName</key>
            <value>Dimitar</value>
          </data>
          <data xsi:type="keyIntValuePair">
            <key>ExpiryMonth</key>
            <value>11</value>
          </data>
          <data xsi:type="keyIntValuePair">
            <key>ExpiryYear</key>
            <value>2024</value>
          </data>
            <data xsi:type="keyStringValuePair">
            <key>CardVerificationCode</key>
            <value>123</value>
          </data>
        </specificPaymentAccountData>
    </paymentAccount>
</initiatePaymentRequest>

Example initiatePaymentRequest for subsequent deposits, providing paymentAccountID:

<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>B2BTestMerchant</merchantID>
    <shopID>ProviderTesting</shopID>
    <merchantTransactionID>e-new22443-442424a</merchantTransactionID>
    <paymentMethodID>367</paymentMethodID>
    <amount currencyCode="USD">20000.05</amount>
    <userID>bc1544de-7443-45f6-976e-ge</userID>
    <userData></userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>44412fac-ec9d-44de-b511-5a5cc00ada80</userSessionID>
    <creationTypeID>1</creationTypeID>
      <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>PayerPassword</key>
         <value>PS1234</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescription</key>
            <value>Description of payment: short description</value>
      </data>
     <data xsi:type="keyStringValuePair">
        <key>PaymentDescriptionLanguageCode</key>
          <value>en</value>
        </data>
    </specificPaymentData>
    <paymentAccountID>cfb99453-95c2-4034-8234-1f42525</paymentAccountID>
</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>B2BTestMerchant</merchantID>
        <shopID>ProviderTesting</shopID>
        <paymentMethod>
            <key>367</key>
            <value>GamersCardDeposit</value>
        </paymentMethod>
        <merchantTransactionID>e-4242-22225</merchantTransactionID>
        <paymentID>0434f6a4-9a64-4f8b-ab56-c7b0c525f204</paymentID>
        <userID>bc1544de-7443-45f6-976e-ge</userID>
        <paymentProvider>
            <key>188</key>
            <value>CREDTA</value>
        </paymentProvider>
        <amount currencyCode="USD">10.05</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>5c584d41-db7f-4157-b699-8474bf3d2573</id>
            <definition>
                <key>29</key>
                <value>DepositedByProvider</value>
            </definition>
            <createdOn>2020-04-28T08:48:17.8183967Z</createdOn>
            <paymentStateDetails xsi:nil="true"></paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">6.67</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>1530</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>1753852</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>cfb99453-95c2-4034-8234-1f42525</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>MaskedNumber</key>
                    <value>************0114</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountOwnerToken</key>
                    <value>bfc3b5fb-7edc-4581-80c4-e6a2f6382d7d</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryMonth</key>
                    <value>11</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryYear</key>
                    <value>2024</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>HolderName</key>
                    <value>Dimitar</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 Breakdown.

DepositedByProvider (29)

Success state; payment has been executed.

DepositRequestSentToProviderCommunicationErrorOccured (353)

Error state; payment request was incorrect or provider was unreachable.

RefusedByProvider Breakdown

The general case of a refused transaction, where the provider has returned an error code and error message.

<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>B2BTestMerchant</merchantID>
        <shopID>ProviderTesting</shopID>
        <paymentMethod>
            <key>367</key>
            <value>GamersCardDeposit</value>
        </paymentMethod>
        <merchantTransactionID>e-new22443-22225</merchantTransactionID>
        <paymentID>5a68766d-c554-4e05-b46d-039f52333efe</paymentID>
        <userID>bc1544de-7443-45f6-976e-ge</userID>
        <paymentProvider>
            <key>188</key>
            <value>CREDTA</value>
        </paymentProvider>
        <amount currencyCode="USD">10.05</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>b7b1d4e4-418e-47e7-b589-fe59802879e7</id>
            <definition>
                <key>100</key>
                <value>RefusedByProvider</value>
            </definition>
            <createdOn>2020-04-28T08:50:28.9735424Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseCode</key>
                    <value>E2003</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>INVALID CARD OR CREDENTIALS DATA</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">6.67</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>1753853</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>cfb99453-95c2-4034-8234-1f42525</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>MaskedNumber</key>
                    <value>************0114</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountOwnerToken</key>
                    <value>bfc3b5fb-7edc-4581-80c4-e6a2f6382d7d</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryMonth</key>
                    <value>11</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryYear</key>
                    <value>2024</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>HolderName</key>
                    <value>Dimitar</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>CardType</key>
                    <value>MastercardDebit</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

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.

The GamersCard specific case of a refused transaction, where the provider has refused the transaction due to insufficient funds on the merchant account.

<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>B2BTestMerchant</merchantID>
        <shopID>ProviderTesting</shopID>
        <paymentMethod>
            <key>367</key>
            <value>GamersCardDeposit</value>
        </paymentMethod>
        <merchantTransactionID>e-new22443-22225</merchantTransactionID>
        <paymentID>5a68766d-c554-4e05-b46d-039f52333efe</paymentID>
        <userID>bc1544de-7443-45f6-976e-ge</userID>
        <paymentProvider>
            <key>188</key>
            <value>CREDTA</value>
        </paymentProvider>
        <amount currencyCode="USD">10.05</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>b7b1d4e4-418e-47e7-b589-fe59802879e7</id>
            <definition>
                <key>100</key>
                <value>RefusedByProvider</value>
            </definition>
            <createdOn>2020-04-28T08:50:28.9735424Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderStatusCode</key>
                    <value>110</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">6.67</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ElectronicCommerceIndicator</key>
                <value>07</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>1753853</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>cfb99453-95c2-4034-8234-1f42525</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>MaskedNumber</key>
                    <value>************0114</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>AccountOwnerToken</key>
                    <value>bfc3b5fb-7edc-4581-80c4-e6a2f6382d7d</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryMonth</key>
                    <value>11</value>
                </detail>
                <detail xsi:type="keyIntValuePair">
                    <key>ExpiryYear</key>
                    <value>2024</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>HolderName</key>
                    <value>Dimitar</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>CardType</key>
                    <value>MastercardDebit</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>