Neteller Deposit

Neteller is a popular e-Wallet payment method offered in various countries throughout Europe.

The following method IDs are covered in this section:

IDNameCredit/Debit State
4NetellerDepositExecutedByProvider (142)

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

Redirect Integration

Supported.

Backend2BackendIntegration - Neteller Balance Enquiry

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

3 types of input request.

  1. Input Request with only NetellerAccountIdentifier
  2. Input Request with only paymentAccountID
  3. Input Request with paymentAccountID,ServiceCode,HomePageUrl

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

key (value type, account type, required)value
PaymentAccountID (string)The unique id of the payment account in PS
ServiceCode (string)The authorization code to access the Neteller account
HomePageUrl (string)URI used during generation of the authorization code
NetellerAccountIdentifier (string)AccountID or EMail address at Neteller
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://www.cqrpayments.com/PaymentProcessing">
   <soapenv:Header/>
   <soapenv:Body>
      <getPaymentInputDataRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
         <merchantID>YourMerchantID</merchantID>
         <shopID>YourShopID</shopID>
         <user>
            <id>7777777777</id>
         </user>
         <paymentMethodID>4</paymentMethodID>
         <details>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>NetellerAccountIdentifier</key>
               <value>450824016049</value>
            </data>
         </details>
      </getPaymentInputDataRequest>
   </soapenv:Body>
</soapenv:Envelope>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2015-10-14T05:18:21.007Z</u:Created>
            <u:Expires>2015-10-14T05:23:21.007Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
         <paymentInputData>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>AccountID</key>
               <value>450824016049</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Email</key>
               <value>[email protected]</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>FirstName</key>
               <value>INRFirstname</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>LastName</key>
               <value>INRLastname</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>DateOfBirth</key>
               <value>01/01/1984</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Country</key>
               <value>GB</value>
            </data>
<data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>VerificationLevel</key>
               <value>11</value>
            </data>

         </paymentInputData>
      </getPaymentInputDataResponse>
   </s:Body>
</s:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://www.cqrpayments.com/PaymentProcessing">
   <soapenv:Header/>
   <soapenv:Body>
      <getPaymentInputDataRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
         <merchantID> YourMerchantID</merchantID>
         <shopID>YourShopID</shopID>
         <user>
            <id>99999</id>
         </user>
         <paymentMethodID>4</paymentMethodID>
         <details>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>PaymentAccountID</key>
               <value>323232</value>
            </data>
         </details>
      </getPaymentInputDataRequest>
   </soapenv:Body>
</soapenv:Envelope>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2015-10-14T05:19:24.418Z</u:Created>
            <u:Expires>2015-10-14T05:24:24.418Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
         <paymentInputData>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>AccountID</key>
               <value>458591047553</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Email</key>
               <value>[email protected]</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>FirstName</key>
               <value>GBPFirstname</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>LastName</key>
               <value>GBPLastname</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>DateOfBirth</key>
               <value>03/01/1978</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Country</key>
               <value>GB</value>
            </data>
<data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>VerificationLevel</key>
               <value>11</value>
            </data>

         </paymentInputData>
      </getPaymentInputDataResponse>
   </s:Body>
</s:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://www.cqrpayments.com/PaymentProcessing">
   <soapenv:Header/>
   <soapenv:Body>
      <getPaymentInputDataRequest xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
         <merchantID> YourMerchantID</merchantID>
         <shopID>YourShopID</shopID>
         <user>
            <id>99999</id>
         </user>
         <paymentMethodID>4</paymentMethodID>
         <details>
           <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>PaymentAccountID</key>
               <value>323232</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>ServiceCode</key>
               <value>0.AAAAAVBhU20bAAAAAAAEk-BpbN6wnhmcozNKE0QVKqtS.K0dG-4WLMDqNhKW257Uj7Rn0RqE</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>HomePageUrl</key>
               <value>https://www.mysite.com/cashier</value>
            </data>
         </details>
      </getPaymentInputDataRequest>
   </soapenv:Body>
</soapenv:Envelope>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
   <s:Header>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <u:Timestamp u:Id="_0">
            <u:Created>2015-10-13T13:12:12.680Z</u:Created>
            <u:Expires>2015-10-13T13:17:12.680Z</u:Expires>
         </u:Timestamp>
      </o:Security>
   </s:Header>
   <s:Body>
      <getPaymentInputDataResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
         <paymentInputData>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>AccountID</key>
               <value>458591047553</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Email</key>
               <value>[email protected]</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>FirstName</key>
               <value>GBPFirstname</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>LastName</key>
               <value>GBPLastname</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>DateOfBirth</key>
               <value>03/01/1978</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Country</key>
               <value>GB</value>
            </data>
<data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>VerificationLevel</key>
               <value>11</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Amount</key>
               <value>547424255.19</value>
            </data>
            <data xsi:type="keyStringValuePair" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <key>Currency</key>
               <value>GBP</value>
            </data>
         </paymentInputData>
      </getPaymentInputDataResponse>
   </s:Body>
</s:Envelope>

Backend2BackendIntegration

The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentAccountData xml section:

key (value type, account type, required)value
AccountID
(string, required)
User’s account ID for Neteller provider
AccountVerificationCode (string, required)Account’s verification code (like CVC for credit cards)

There are no specificPaymentData.

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>3e11b2f1-1d92-4ddd-8d43-9de4e77e4118</merchantTransactionID>
    <paymentMethodID>4</paymentMethodID>
    <amount currencyCode="EUR">15</amount>
    <userID>d48693ca-e96e-4ca1-9e01-435115a79344</userID>
    <userData></userData>
    <userIP>127.0.0.1</userIP>
    <userSessionID>9a156eae-d903-4a01-8170-20dae92673d3</userSessionID>
    <creationTypeID>1</creationTypeID>
    <paymentAccountID>3fs11u2ve4m89a4yfyd6jdf</paymentAccountID>
    <paymentAccount>
        <isVisible>false</isVisible>
        <specificPaymentAccountData>
            <data xsi:type="keyStringValuePair">
                <key>AccountID</key>
                <value>1234567890</value>
            </data>
            <data xsi:type="keyStringValuePair">
                <key>AccountVerificationCode</key>
                <value>12345</value>
            </data>
        </specificPaymentAccountData>
    </paymentAccount>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <payment>
        <merchantID>YourMerchantID</merchantID>
        <shopID>YourShopID</shopID>
        <paymentMethod>
            <key>4</key>
            <value>NETeller Deposit</value>
        </paymentMethod>
        <merchantTransactionID>3e11b2f1-1d92-4ddd-8d43-9de4e77e4118</merchantTransactionID>
        <paymentID>667d5032-335e-462c-9244-fa8bc7a9f441</paymentID>
        <userID>d48693ca-e96e-4ca1-9e01-435115a79344</userID>
        <paymentProvider>
            <key>21</key>
            <value>Neteller</value>
        </paymentProvider>
        <amount currencyCode="EUR">15</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>b118842e-0b77-4e4f-803d-144b47b2d977</id>
            <definition>
                <key>142</key>
                <value>ExecutedByProvider</value>
            </definition>
            <createdOn>2011-05-18T16:14:32.2575197Z</createdOn>
            <paymentStateDetails xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"></paymentStateDetails>
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">15.00</baseAmount>
        <paymentDetails xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"></paymentDetails>
    </payment>
</initiatePaymentResponse>

The following result states apply to the payment method NetellerDeposit:

Payment StatesDescription
ExecutedByProvider (142)Success state; redirect user to SuccessfulPageUrl
ProviderCommunicationErrorOccurred (233)Error state; Communication error during payment finalization
RefusedByProvider (100)Error state, payment was not accepted by provider; redirect user to ErrorPageUrl.
BlockedByPaymentScoring (202)Error state; Refused by the Kalixa Risk System
RefusedByPaymentScoring (121)Error state; Refused by the Kalixa Risk System

Notifications

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

In the Merchant Notification message “UserFirstName”, “UserLastName” and “UserEmail” parameters will be sent (in the paymentAccount.details collection the elements with “userFirstName”, “userLastName” and “userEmail” keys)

Example handlePaymentStateChangedNotificationRequest:

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest 
    xmlns="http://www.cqrpayments.com/PaymentProcessing" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>KalixaAcceptDEMO</merchantID>
        <shopID>KalixaAcceptDEMO</shopID>
        <paymentMethod>
            <key>4</key>
            <value>NETeller Deposit</value>
        </paymentMethod>
        <merchantTransactionID>20141211_5</merchantTransactionID>
        <paymentID>3a5eff92-3d62-4b8f-bcb1-5cd8a7f56637</paymentID>
        <userID>KalxiaTestUser_3</userID>
        <paymentProvider>
            <key>21</key>
            <value>Neteller</value>
        </paymentProvider>
        <amount currencyCode="GBP">10.0000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>195.72.132.1</userIP>
        <state>
            <id>6afcb3d1-78d5-427d-aafa-b6a7733510b5</id>
            <definition>
                <key>142</key>
                <value>ExecutedByProvider</value>
            </definition>
            <createdOn>2014-12-11T15:33:46.52</createdOn>
            <paymentStateDetails xsi:nil="true" />
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">12.6500</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>711216</value>
            </detail>
            <detail xsi:type="keyIntValuePair">
                <key>PaymentScoring</key>
                <value>711216</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>NetellerUserFirstName</key>
                <value>TestFirstName</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>NetellerUserLastName</key>
                <value>TestLastName</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>NetellerUserEmail</key>
                <value>[email protected]</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>635539088264118179</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>906004704</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>accountID</key>
                    <value>224455667788</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>userFirstName</key>
                    <value>TestFirstName</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>userLastName</key>
                    <value>TestLastName</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>userEmail</key>
                    <value>[email protected]</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</handlePaymentStateChangedNotificationRequest>

Provider Error Codes

ProviderResponseCodeProviderResponseMessage
5001Invalid currency - The submitted an currency code is invalid or your account does not support this currency.
5010Invalid country - The submitted country code is invalid.
5016Account not found - The account you provided cannot be found.
5017Account disabled - The account you provided is disabled.
5023Bad request - The request is not parseable.
5042Invalid merchant reference - This error usually indicates that a transaction was attempted with the merchant reference field missing. This value is mandatory and must be included with your request.
5068Invalid field - Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected.
5275Authentication credentials expired - The authentication credentials provided with the request have expired.
5276Authentication credentials disabled - The authentication credentials provided with the request provided have been disabled.
5277Authentication credentials locked - The authentication credentials provided with the request have been locked due to multiple authentication failures.
5278Cannot authenticate - The authentication credentials provided with the request were not accepted for an unknown reason.
5279Authentication credentials are invalid - The authentication credentials are invalid.
5270Unauthorized access - The credentials provided with the request do not have permission to access the requested data.
5269Entity not found - The ID(s) specified in the URL do not correspond to the values in the system.
5273URI not found - Your client reached our application but we were unable to service your request due to an invalid URL.
5271Unsupported 'Accept' header - You requested a response in the 'Accept' header that is in an unsupported format.
5272Unsupported 'Content-Type' - The 'Content-Type' you specified in request header was submitted in an unsupported format.
1200API call rate exceeded - The API call has been denied as it has exceeded the permissible call rate limit.
1000Internal error - An internal error occurred.
1002Internal error - Database Error
1003Internal error - Decryption Error
1007Internal error - Gateway Error
20000Unsupported API request - You are not registered to use this API
20001Account closed - The account is closed
20002Merchant account inactive - Your merchant account is currently inactive.
20003Invalid merchant account currency - Your NETELLER Merchant Account does not support this currency.
20005Duplicate transaction reference - The provided transaction reference has already been used for another transaction. You must provide a unique value for each request.
20006Invalid amount format - Amount must be numeric and cannot contain decimals or any alpha characters.
20007Invalid accountId or email - The specified accountId or email is invalid.
20008Invalid verification code The supplied verification code was not valid for this request.
20010Merchant blocked geolocation - Member is residing in a blocked country/state/region (merchant has chosen to block members from transacting in that location)
20011NETELLER blocked geolocation - Member is residing in a NETELLER blocked country/state/region.
20015Member is not entitled. - Member is not entitled to receive this type of transaction.
20016Merchant is not entitled. - Merchant is not entitled to initiate this type of transaction.
20020Insufficient balance - Insufficient balance to complete the transaction.
20021Below member min transfer amount - The specified amount is below defined minimum transfer limits.
20022Above max transfer out amount - The specified amount is above defined maximum transfer out limits.
20025Below merchant min transfer amount - The specified amount is below your defined minimum transfer limits.
20026Above max transfer in amount - The specified amount is above defined maximum transfer in limits.
20030Below min transaction limit - The specified amount is too low. You must specify an amount greater than or equal to 1 unit of currency.
20031Above max transaction limit - The specified amount is too high. You must specify an amount within your transactional limit.
20035Above max account limit - The transaction exceeds allowed account limits.
20040Expired - The transaction was not completed in the permitted time and has expired.
20045Merchant declined - Transaction was manually cancelled or declined by the merchant.
20050Legacy transaction details not available from this API, use NetCheck - The transaction you are trying to retrieve was submitted using the legacy NetDirect or Instant Payout API. Please use NetCheck to retrieve the associated error detail for the transaction.
20100Plan already exists - The requested planId has already been used. Please specify a unique planId with your request.
20101Cannot delete a subscribed to plan - You cannot delete a subscription plan that has already been subscribed to. If you wish to prevent further enrollment in this plan then you must cancel the plan .
20102Invalid term length - The term length for this subscription plan is invalid. Please ensure the interval, interval type and interval count combination is less than 5 years.
20200Existing member email - The supplied email is already registered with NETELLER.
20900Request not authorized - Your request was not authorized as the API requires member authorization. Please use the authorization_grant flow to obtain member permission for the required scope.