DengiOnline

2017-07-29 03:29:16

COMMISSIONS action

List of all available Payment Service Providers, their parameters and commissions

The System contains about 10 thousand providers available for payments and the number constantly increases. Up-to-date information is available via API.

This action returns an actual list of service providers available for payments and additional parameters required for making payments towards recipients in these payment provider’s systems.

Request Parameters

To request the list of available services you only need to send the standard set of the required parameters.

Response Parameters

The GSG System response in XML format apart from the basic parameters contains the following nodes:

Parameter

Description

Format

The services node (which wraps a payment system description) contains the following tags:

id

Payment Service Provider ID

integer

tag

Payment Service Provider mnemonic ID - alias

string (255)

title

Payment Service Provider name

string (255)

min_amount

Minimum payment amount required by the provider

decimal (11.2)  delimiter — decimal point

max_amount

Maximum payment amount indicated by the provider

decimal (11.2)  delimiter — decimal point

account_name

Hint for the recipient ID

string

account_regexp

Regular expression for the recipient ID validation For example, /^\d{10}$/ (expression for phone number validation).

string

currency_id

Paymant system currency

string / integer

ISO 4217 number-3

The extra node contains the additional tags helping to provide the payment:
game_rate Rate of game currency to the service currency decimal (11.7)

The params node contains the following tags, specific for the payment recipient:

name

Parameter name. In the payment request — tag name in the params node

For example, cardholder’s name.

string

descr

Parameter description

For example, card expiration date (in MMYY format).

string

regexp

Regular expression for parameter validation

For example, /^[\d]+$/ (for cardholder’s phone number in international format).

string

mandatory

A sign of mandatory of parameter:

  • y – parameter is mandatory, 
  • n – is not

string
y / n 

 

The protection node contains information about payment processing with protection (Only for payments with protection):
type Type of request (optional or mandatory)

string

optional / mandatory

field The node contains fields for operating with protection code  
name Name of the field sending information for operating with protection code  
descr Description of the field sending information for operating with protection code  
The commissions node contains information about values of commissions:
percent percent of partner's compensation decimal (11.4) разделитель – точка
fix fixed part of commission decimal (11.4) разделитель – точка
fix_currency currency for fix, min and max amount of commission

string / integer

ISO 4217 number-3

min_commission the minimum amount of commission decimal (11.4) разделитель – точка
max_commission the maximum amount of commission decimal (11.4) разделитель – точка
payer Commission payer (client – natural person, recipient; partner – partner, sender)

string

partner / client

Request example

<?xml version="1.0" encoding="UTF-8"?>
<request>
    <action>commissions</action>
    <project>1234</project>
    <timestamp>1358429485</timestamp>
    <sign>d5fc59667fdae3f97e7527beed553d80</sign>
</request>

Response example (success)

<?xml version="1.0" encoding="UTF-8"?> 
<response>
    <status>1</status>
    <reference>243</reference>
    <timestamp>1441951927</timestamp>
    <services>
        <service>
            <id>2</id>
            <tag>qiwi</tag>
            <title>QIWI-Wallet Russia</title>
            <min_amount>10.0000</min_amount>
            <currency_id>643</currency_id>
            <max_amount>15000.0000</max_amount>
            <account_name>QIWI-wallet number (phone number wallet is registered to)</account_name>
            <account_regexp>/^\d+$/</account_regexp>
            <commission>
                <percent>-2.0000</percent>
                <fix>0.0000</fix>
                <fix_currency>643</fix_currency>
                <min_commission />
                <max_commission />
                <payer>partner</payer>
            </commission>
        </service>
    </services>
</response>

Response example (failure)

<?xml version="1.0" encoding="UTF-8"?> 
<response>
    <status>14</status>
    <reference>25237</reference>
    <timestamp>1358430240</timestamp>
</response>