Merchant Platron API RU

Embed Size (px)

DESCRIPTION

Merchant Platron API

Citation preview

  • Platron API

    2.0

  • 2

    ............................................................................................................................... 3 ................................................................................................................................... 7 .......................................................................................................................... 7 Platron' ........................................... 7

    Platron ....................................... 8 Platron ....... 9

    ............................................................................................. 10 .............................................................................................................. 12

    ................................................................................................................................... 12 ................................. 15 Platron .............................. 16

    ............................................................................... 18 ........................................................................................................................ 20 ........................................................................................ 23 ( )...................................................... 24 ......................................................................................... 26 ................................................................................................................................ 27 ................................................................................................................ 28

    ............................................................................... 28 ...................................................................................... 28 ................................................................................................................................... 28

    .......................................................................................................... 29 ......................................................................... 29 .................................................................................................... 32 ......................................................... 34 ( ) ............................................................................... 35 .......................................................................................... 36 .......................................................................................................... 40 ............................................................................... 41 ................................................ 42 ....................................................................................................................... 43

    .................................................................................................... 43 .................................................................................... 44 .......................................................................... 47 ........................................................................................................................ 47 Platron ............................................ 48 , ........................................... 48 ................................................................................................. 49

    ......................................................................................................................... 49 ............................................................................................................... 49 .................................................................................................................... 49 ................................................................................................................. 50

    ......................................................................................................................... 50

  • 3

    0.1.20090608

    08.06.2009

    .

    0.1.20090609

    09.06.2009

    .

    ,

    0.1.20090611

    11.06.2009

    .

    Platron Check URL Result URL

    0.1.20090618

    18.06.2009

    .

    . Platron Check URL.

    . Platron . . . . , .

    0.1.20090701

    01.07.2009

    .

    ,

    0.1.20090716

    16.07.2009

    .

    check ,

    0.1.20090720

    20.07.2009

    .

    Failure URL Success URL

    0.1.20090810

    10.08.2009

    .

    . . pg_redirect_url_type=need data. check result.

    0.1.20090817

    17.08.2009

    .

    pg_redirect_url_type=need data.

    0.1.20090827

    27.08.2009

    .

    Check URL: rejected, pg_error_description pg_description, error.

    0.1.20090903

    03.09.2009

    Check URL: pg_net_amount

  • 4

    .

    0.1.20091026

    26.10.2009

    .

    , .

    1.0.20091029

    29.10.2009

    .

    . .

    1.1.20091112

    12.11.2009

    . .

    . ( pg_salt pg_sig). .

    1.2.20091211

    11.12.2009

    .

    . , TRANSCRED, COMEPAY WEBMONEYRBANK

    1.2.20091222

    22.12.2009

    .

    Platron secret_key , 101.

    1.3.20100212

    12.02.2010

    .

    .

    1.3.20100226

    26.02.2010

    .

    , .

    1.3.20100309

    09.03.2010

    .

    pg_payment_scenario .

    1.3.20100408

    08.04.2010

    .

    .

    1.4.20100415

    15.04.2010

    .

    pg_user_ip.

    1.5.20100713

    13.07.2010

    .

    API- .

    1.5.20100726

    26.07.2010

    .

    pg_lifetime.

    1.5.20100830

    30.08.2010

    .

    , . pg_description.

    1.6.20101015

    15.10.2010

    .

    Result URL: pg_user_phone.

    1.6.20101020

    20.10.2010

    .

    pg_lifetime.

    1.6.20101110

    10.11.2010

    .

    site_url.

  • 5

    1.6.20101126

    26.11.2010

    .

    pg_accepted_payment_systems.

    1.6.20110210

    10.02.2011

    .

    . .

    1.6.20110525

    25.05.2011

    .

    , .

    1.6.20110701

    01.07.2011

    .

    API TESTCARD, . pg_user_contact_email .

    1.6.20110721

    21.07.2011

    .

    : pg_postpone_payment

    1.6.20110825

    25.08.2011

    .

    .

    1.7.20111216

    16.12.2011

    .

    . .

    1.7.20120228

    28.02.2012

    .

    1.7.20120321

    21.03.2012

    .

    pg_card_brand Result URL. , .

    1.7.20120425

    25.04.2012

    .

    clearing, TRANSCRED, RUSSIANSTANDARD, MASTERBANKCARD.

    , TRANSCRED, MASTERBANKCARD. . . Result URL Success URL.

    1.7.20120614

    14.06.2012

    .

    . Site URL .

    1.7.20120725

    25.07.2012

    .

    1.7.20120815

    15.08.2012

    .

    pg_auth_code Result URL. ( get_status.php) pg_order_id. .

    1.7.20130222

    22.02.2013

    .

    pg_card_pan Result URL. .

    1.8.20130517

    17.05.2013

    .

  • 6

    . -.

    1.8.20130920

    . .

    GDS Amadeus. . . .

    2.0 26.03.2014

    . ,

    Qiwi QIWIREST TINKOFFBACKCARD RUSSIANSTANDARD Platron Platron

  • 7

    , . , (webmoney, ., , , ..) . () , platron.ru.

    1. 2. 3. 4. Platron.ru

    URL 5. /

    Platron' Platron :

    1. , URL 2.

    .

    : , Platron , pg_, .

    . , . . .

    ( ) Platron . ';':

    1. ( '/' '?') 2. , pg_salt,

    , : a. ( XML) b. ,

    3. secret_key,

    Platron. md5 pg_sig. MD5 (32 ). : http://domain.com/path/to/script.php

    9imM909TH820jwk387

    value3

    value1

  • 8

    subvalue2

    subvalue1

    value2

    74aa41a4f425d124a23c3a53a3140bdc15826

    pg_sig :

    pg_sig = md5(script.php + ;+ pg_a_param + ; + pg_b_param + ; +

    pg_salt + ;+ pg_t_param + ; + pg_m_subparam + ;+ pg_q_subparam +

    ;+ secret_key);

    pg_sig = md5(

    'script.php;value1;value2;9imM909TH820jwk387;value3;subvalue1;subvalue2;my

    passkey');

    , secret_key mypasskey.

    , . .

    , pg_salt pg_sig Platron secret_key. pg_error_code ( ) 101. pg_error_code . . https://www.platron.ru/admin/sig_debug_helper.php.

    Platron Platron:

    1. GET GET GET, , , :

    https://www.platron.ru/script.php?param_1=val1&param_2[subparam_1]=val2&

    param_2[subparam_2]=val3&param_3=val4

    2. POST POST. POST, .

    3. XML POST pg_xml, XML :

    value1

  • 9

    value2

    value3

    (GET, POST XML) XML :

    ok

    value1

    value2

    value3

    XML utf-8. pg_status, . pg_status ok , error . : pg_error_code ( ; . ) pg_error_description ( ). :

    19imfwM909TH820jwk387

    error

    200

    amount not specified

    ccde41a4f425d124a23c3a53a3140bdc158ac

    pg_status, ok error.

    Platron Platron . .

    Platron :

    1. , 2. , .

    Platron :

  • 10

    1. 302 (HTTP Location). GET. 2. - . GET POST. ,

    , action . hidden . onload. , . :

    platron.ru:

    , platron.ru

    , platron.ru

    Platron (Request Method)

    Platron :

    ( Check URL)

    ( Result URL) : GET, POST, XML. . Platron

    URL (Check URL)

    URL , . (, ). URL , .

    URL (Result URL)

    URL , . URL , .

    URL (Refund URL)

    URL , . URL , .

    URL (Capture URL)

    URL , . URL , .

    State URL URL , ,

    State URL

    GET , GET. POST , POST. AUTOGET 302 . . , .1. AUTOPOST , . .

  • 11

    , .2. GET POST, platron.ru, , . AUTOGET AUTOPOST, , .

    Success URL URL ,

    Success URL

    (Success URL

    Method)

    GET , GET. POST , POST. AUTOGET 302 . . , .1. AUTOPOST , . . , .2. GET POST, platron.ru, , . AUTOGET AUTOPOST, , .

    Failure URL URL , . Success URL

    Failure URL

    (Failure URL

    Method)

    GET , GET. POST , POST. AUTOGET 302 . . , .1. AUTOPOST , . . , .2. GET POST, platron.ru, , . AUTOGET AUTOPOST, , .

    Site URL URL , . offline ().

    , , , . , , , . , .

    (secret_key)

    , Platron Platron

    , secret_key, .

  • 12

    ( ) :

    1. Platron 2. Platron

    : 1. ,

    Platron. 2. Platron,

    URL , URL.

    , .

    (

    )

    pg_merchant_id Platron. .

    pg_order_id . .

    pg_amount pg_currency

    pg_currency RUR , . RUR, USD, EUR. , . . .

    pg_check_url Check URL

    (string[256]) URL . , . , . , .

    pg_result_url Result URL

    (string[256]) URL . . , . , Platron .

    pg_refund_url Refund URL

    (string[256]) URL . Platron . , .

    pg_capture_url Capture URL

    (string[256]) URL . , .

    pg_request_method Request Method

    (string[4]) GET, POST XML Check URL, Result URL, Refund URL, Capture URL .

  • 13

    pg_state_url State URL

    (string[256]) url, ( online )

    pg_state_url_method State URL

    Method

    GET , GET. POST , POST. AUTOGET 302 . . , .1. AUTOPOST , . . , .2. GET POST, platron.ru, , . AUTOGET AUTOPOST, , .

    pg_success_url Success URL

    (string[256]) url, ( online )

    pg_failure_url Failure URL

    (string[256]) url, ( online )

    pg_success_url_method Success URL

    Method

    GET , GET. POST , POST. AUTOGET 302 . . , .1. AUTOPOST , . . , .2. GET POST, platron.ru, , . AUTOGET AUTOPOST, , .

    pg_failure_url_method Failure URL

    Method

    GET , GET. POST , POST. AUTOGET 302 . . , .1. AUTOPOST , . . , .2. GET POST, platron.ru, , . AUTOGET AUTOPOST,

  • 14

    , .

    pg_site_url Site URL

    URL , . offline ().

    pg_payment_system . : WEBMONEY, YANDEXMONEY, EUROSET, CYBERPLATCASH, CASH. . . . , platron.ru1

    pg_lifetime ( ) , Platron . Platron, , , . . . : 300 (5 ). : 604800 (7 ). ,

    pg_encoding UTF-8 , ( GET POST)

    pg_description (string[1024]) . . pg_encoding.

    pg_user_phone2 (int[16]) ( 79..), . , .

    pg_user_contact_email2 (string[100]) . , .

    pg_user_email2 (string[120]) , @Mail.ru. , . ,

    1 PSI DSS . 2 . .

  • 15

    .

    pg_user_ip2 IP- . . , IP, .

    pg_postpone_payment (http://www.platron.ru/info/postponed_payment), 1. , . , pg_user_contact_email, , , email .

    pg_language ru Platron ( ) . ru , en .

    pg_testing_mode

    , 0 1. . .

    pg_recurring_start 0 , 0 1. . .

    pg_recurring_lifetime . 1 (1 ). : 156 (13 ). , . . .

    , pg_. pg_check_url, pg_result_url, pg_success_url, pg_failure_url. .

    pg_salt

    pg_sig

    , POST GET URL http://www.platron.ru/payment.php https://www.platron.ru/payment.php.

    GET :

  • 16

    https://www.platron.ru/payment.php?pg_merchant_id=111&pg_amount=1000&pg_or

    der_id=123&pg_check_url=http://www.shop.ru/check.php&pg_result_url=http://

    www.shop.ru/result.php&pg_success_url=http://www.shop.ru/thankyou.php&pg_f

    ailure_url=http://www.shop.ru/failed.php&pg_description=Ticket+SU1234+Mosc

    ow-

    Berlin+1+Jun+2008&custom_param1=gagaga&custom_param2=gugugu&pg_sig=af8e41a

    4f425d124a23c3a53a3140bdc17ea0

    . , ( , , ), platron.ru.

    Platron Platron URL https://www.platron.ru/init_payment.php.

    Platron XML :

    ijoi894j4ik39lo9

    ok

    15826

    https://www.platron.ru/payment_params.php?customer=ccaa

    41a4f425d124a23c3a53a3140bdc15826

    need data

    af8e41a4f425d124a23c3a53a3140bdc17ea0

    :

    pg_payment_id Platron. .

    pg_redirect_url URL . platron.ru,

    pg_redirect_url_type , . : need data : , , ; payment system . platron.ru, .

    pg_accepted_payment_systems pg_redirect_url_type = payment_system, , . , .

    pg_salt

    pg_sig

  • 17

    pg_redirect_url_type=need data, URL, . . - , pg_ps_additional_data, :

    c1058bea

    ok

    17837

    EUROSET,ELECSNET,UNIKASSA,COMEPAY,RAPIDA

    https://www.platron.ru/ps/rapida/start_payment.php?no=939

    f392abc4e847ca340b237c79cd8a817837

    payment system

    RAPIDA

    22

    13daa252681721b5f9ae176e57cc1d70

    , , .

    :

    error

    101

    Empty merchant

    :

    pg_error_code

    pg_error_description

    , , ( , , ), pg_redirect_url platron.ru, .

  • 18

    , Check URL Request Method. utf-8, . 30 . , Check URL , . Check URL , , . Check URL , , , .

    Check URL:

    pg_order_id

    pg_payment_id platron.ru

    pg_amount ( pg_currency), pg_amount

    pg_currency , pg_currency

    pg_ps_amount ( pg_ps_currency),

    pg_ps_full_amount ( pg_ps_currency),

    pg_ps_currency ,

    pg_payment_system

    , - , "pg_"

    pg_salt

    pg_sig

    GET :

    http://store.ru/check.php?pg_salt=8765&pg_order_id=654&pg_payment_id=765432&pg_p

    ayment_system=WEBMONEYR&pg_amount=100.00&pg_currency=RUR&pg_net_amount=95.00&pg_

    ps_amount=100.00&pg_ps_currency=RUR&pg_ps_full_amount=100.80&pg_sig=bfc5f9d23795

    2f56bd05c602d287096e&uservar1=45363456

    xml (POST XML pg_xml) :

    8765

    654

    765432

    WEBMONEYR

    100.00

    RUR

    RUR

    100.00

  • 19

    100.00

    45363456

    bfc5f9d237952f56bd05c602d287096e

    , XML ok.

    654j8rlvbyuj

    ok

    300

    6e952f52d23770986bd05c6fc5f902db

    rejected , pg_description ( ), . , rejected, , Check URL (, Platron ).

    654j8rlvbyuj

    rejected

    d2377096e952f5286bd05c602dbfc5f9

    error . , , .

    654j8rlvbyuj

    error

    1000

    database connection failed

    8a417096e952f5286bd05c602dbfc562

    Platron :

    pg_status ok rejected error

  • 20

    pg_description (string[1024]) . , . , pg_error_description.

    pg_timeout (int[10]) , , 600

    pg_error_description pg_status=error

    pg_salt

    pg_sig

    Check URL , , .

    Platron Result URL Request Method . utf-8, . , . pg_can_reject=1 (, ), rejected, platron.ru . pg_description . Result URL ( 30 ) , platron.ru 2 , pg_lifetime . Result URL , , , Platron Result URL . , Result URL . , (pg_lifetime) .

    , Result URL:

    pg_order_id

    pg_payment_id platron.ru

    pg_amount ( pg_currency), pg_amount

    pg_currency , pg_currency

    pg_net_amount ( pg_currency), ,

    pg_ps_amount ( pg_ps_currency), . .

    pg_ps_full_amount ( pg_ps_currency), . .

    pg_ps_currency ,

  • 21

    . .

    pg_payment_system

    pg_description . .

    pg_result 1 , 0

    pg_payment_date YYYY-MM-DD HH:MM:SS

    pg_can_reject 1 (, ), 0 . , pg_can_reject=0.

    pg_user_phone ( )

    pg_card_brand

    : CA MasterCard , VI Visa, AX AmericanExpress. .

    pg_card_pan ( ). .

    pg_auth_code . .

    pg_captured 0 1. , ( ). 0, (. ) .

    pg_overpayment

    . , , . , , .

    pg_failure_code

    ( .

    , ). .

    pg_failure_description

    . . .

    pg_recurring_profile_id

    pg_recurring_profile_expiry_date ,

    , - , "pg_"

    pg_salt

    pg_sig

  • 22

    GET :

    http://store.ru/result.php?pg_salt=8765&pg_order_id=654&pg_payment_id=765432&pg_

    payment_system=WEBMONEYR&pg_amount=100.00&pg_currency=RUR&pg_net_amount=95.00&pg

    _ps_amount=100.00&pg_ps_currency=RUR&pg_ps_full_amount=100.80&pg_payment_date=20

    08-12-

    30+23:59:30&pg_can_reject=0&pg_result=1&pg_sig=da61f9d237952f56bd05c602d28780b3&

    uservar1=45363456

    xml (POST XML pg_xml) :

    8765

    654

    765432

    TANSCRED

    100.00

    95.00

    RUR

    RUR

    100.00

    100.00

    1

    0

    2008-12-30 23:59:30

    CA

    012345

    45363456

    da61f9d237952f56bd05c602d28780b3

    , XML ok.

    kdjdope983

    ok

    9bfc5f602d287096ed237952f56bd05c

    , pg_can_reject=1, XML rejected:

    kdjdope983

    rejected

  • 23

    a3fc5f602d287096ed237952f56bd5fa

    pg_status ok rejected ( pg_can_reject=1) error

    pg_description (string[1024]) . , . , pg_error_description.

    pg_error_description , pg_status=error

    pg_salt

    pg_sig

    rejected , pg_can_reject=1, , , . ( rejected), Failure URL, Success URL.

    online Success URL Failure URL, . Success URL Method Failure URL Method, . :

    pg_order_id

    pg_payment_id platron.ru

    pg_card_brand : CA MasterCard , VI Visa, AX AmericanExpress. .

    pg_card_pan ( ). .

    pg_auth_code . .

    pg_captured 0 1. , ( ). 0, (. ) .

    pg_overpayment

    . , ,

  • 24

    . , , .

    pg_failure_code

    Result URL (. ). Failure URL.

    pg_failure_description

    Result URL (. ). Failure URL.

    pg_recurring_profile_id

    pg_recurring_profile_expiry_date ,

    , - , "pg_"

    pg_salt

    pg_sig

    offline .

    GET AUTOGET

    https://store.ru/success.php?pg_salt=1265&pg_order_id=654&pg_payment_id=89768678

    65&uservar1=78945&pg_sig=d52f52379bfc5f96bd602d28096e05c7

    Success URL Failure URL query string, pg_order_id, pg_payment_id query string. , .

    Result URL Success URL. Result URL , Success URL , . Success URL , (, ) Success URL . Result URL, 2 , .

    ( ) Platron Refund URL Request Method. , , , utf-8. 30 . Refund URL ( 30 ) , Platron 2 .

    Refund URL:

    pg_order_id

  • 25

    pg_payment_id Platron pg_amount ( pg_currency),

    pg_amount pg_currency , pg_currency

    pg_net_amount ( pg_ps_currency), pg_ps_full_amount ( pg_ps_currency),

    pg_ps_currency ,

    pg_payment_system pg_refund_date YYYY-MM-DD

    HH:MM:SS pg_refund_type :

    reversal ( ), refund , moneyback , . reversal refund . Reversal , refund .

    pg_refund_system , . pg_refund_type=moneyback. : CONTACT_O MOBILEPHONE_O .

    pg_refund_id . .

    , - , "pg_"

    pg_salt

    pg_sig

    (, ), pg_net_amount pg_ps_full_amount , , ; pg_amount . , .

    GET :

    http://store.ru/refund.php?pg_salt=gw41b38vc&pg_order_id=2614&pg_payment_id=8259

    41&pg_payment_system=CREDITCARD&pg_amount=100.00&pg_currency=RUR&pg_net_amount=1

    00.00&pg_ps_currency=RUR&pg_ps_full_amount=100.80&pg_refund_date=2009-09-30

    15:32:30&pg_sig=afaef9d237932f56bd05c602d287df3a&uservar1=45363456

    xml (POST XML pg_xml) :

  • 26

    gw41b38vc

    2614

    825941

    CREDITCARD

    100.00

    100.00

    RUR

    RUR

    100.00

    2009-09-30 15:32:30

    45363456

    afaef9d237932f56bd05c602d287df3a

    , ok.

    eyhfh42za22h

    ok

    ea362f52d23770986bd05c6fc5f9427d

    pg_status ok error

    pg_error_description , pg_status=error

    pg_salt

    pg_sig

    , - . , (. ), , ( 5 ), , . Capture URL Request Method. 30 . Capture URL ( 30 ) , Platron 2 .

    Capture URL:

    pg_order_id pg_payment_id Platron

  • 27

    , - , "pg_"

    pg_salt

    pg_sig

    GET :

    http://store.ru/onCapture.php?pg_salt=gw41b38vc&pg_order_id=2614&pg_payment_id=8

    25941&pg_sig=afaef9d237932f57bd05c602d287df34&uservar1=45363456

    xml (POST XML pg_xml) :

    gw41b38vc

    2614

    825941

    45363456

    afaef9d237932f57bd05c602d287df34

    , ok.

    eyhfh42za22h

    ok

    ea362f52d23770986bd05c6fc5f9427d

    pg_status ok error

    pg_error_description , pg_status=error

    pg_salt

    pg_sig

    , Platron ( https://www.platron.ru/admin/documents.php) Platron .

    platron.ru pg_payment_system=TEST pg_payment_system=TESTCARD, , , .

  • 28

    , , , .

    , pg_testing_mode . pg_testing_mode=1 , . , pg_testing_mode . Platron.

    c pg_recurring_start, . . , ( , , , ). pg_recurring_lifetime, , , . , , pg_amount = 0, .

    , http://www.platron.ru/make_recurring_payment.php, (. Platron). 30 . :

    (

    )

    pg_merchant_id Platron. .

    pg_order_id . .

    pg_recurring_profile .

    pg_amount

    pg_currency. . , , .

    pg_result_url

    Check

    (string[256]) URL .

  • 29

    URL . , . , Platron .

    pg_refund_url

    Check URL

    (string[256]) URL . Platron . , .

    pg_request_method Check URL

    (string[4]) GET, POST XML Check URL, Result URL, Refund URL, Capture URL .

    pg_encoding UTF-8 , ( GET POST)

    pg_description (string[1024]) . . pg_encoding.

    , pg_. pg_check_url, pg_result_url, pg_success_url, pg_failure_url. .

    pg_salt

    pg_sig

    , Platron Result URL(. )

    , , , . Platron, . http://www.platron.ru/ps_list.php https://www.platron.ru/ps_list.php, (. Platron). 30 . :

    ( )

    pg_merchant_id (string[16])

    pg_amount (decimal) pg_currency.

    pg_currency RUR (string[3])

  • 30

    pg_testing_mode 0 , 0 1. . .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/ps_list.php?pg_salt=123&pg_merchant_id=456&pg_amount=800.

    45&pg_currency=RUR&pg_sig=aec5f9d237952f83bd05c602d287098d

    XML ( POST pg_xml):

    123

    456

    800.45

    RUR

    aec5f9d237952f83bd05c602d287098d

    XML ( utf-8), . , , pg_required, . pg_user_email MONEYMAIL BANKCARDPRU, , pg_alfaclick_client_id ALFACLICK. , pg_additional. . , , , platron.ru. :

    9938745

    ok

    BEELINEPURSE

    offline

    808.67

    RUR

    CASH

    : , ,

  • 31

    offline

    830.00

    RUR

    ELECSNET

    Elecsnet

    EUROSET

    OSMP

    /

    QIWI

    MONEYMAIL

    MoneyMail

    online

    822.00

    RUR

    pg_user_email

    WEBMONEYRBANK

    WebMoney

    online

    810.35

    RUR

    YANDEXMONEY

    -

    online

    812.15

    RUR

    73daf9d237952f56bd05c602d2878dc2

    response . pg_payment_system pg_name . :

    pg_name (string[32])

    pg_description (string[256]) ,

    pg_payment_scenario : offline online

  • 32

    pg_amount_to_pay (decimal) ,

    pg_amount_to_pay_currency ,

    pg_required (string[32]) , . , pg_required.

    pg_sub_name (string[32])

    pg_sub_description (string[256]) , pg_description

    pg_sub_payment_systems

    pg_salt

    pg_sig

    pg_name, pg_sub_name. , , , pg_sub_payment_systems. platron.ru, .

    xml (. Platron).

    Platron , . , , Result URL - , Success URL, . http://www.platron.ru/get_status.php https://www.platron.ru/get_status.php, (. Platron). 30 . ( ):

    pg_merchant_id

    pg_payment_id

    pg_order_id

    . , order_id order_id

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/get_status.php?pg_salt=123&pg_merchant_id=456&pg_payment_

    id=1234567&pg_sig=7f3af9d237952f56bd05c602d2879a3c

    XML ( POST pg_xml):

  • 33

    123

    456

    1234567

    7f3af9d237952f56bd05c602d2879a3c

    XML :

    9865

    ok

    3456547

    failed

    0

    2009-01-12 10:22:30

    2009-01-12 10:25:07

    WEBMONEYR

    5e1af9d237952f56bd05c602d28704ac

    :

    pg_status ( ). ok, . error .

    pg_payment_id Platron pg_transaction_status . .

    pg_can_reject 0 1 . 1 ok . revoke.php .

    pg_create_date

    pg_result_date (ok) (failed) . Result URL. ok, failed revoked.

    pg_revoke_date . revoked.

    pg_payment_system , ( ) .

    pg_card_brand

    : CA MasterCard , VI Visa, AX AmericanExpress. .

    pg_card_pan ( ). .

    pg_auth_code . .

  • 34

    pg_captured 0 1. , ( ). 0, (. ) .

    pg_overpayment

    . , , . , , ok, .

    pg_failure_code

    Result URL (. ). pg_transaction_status = failed revoked.

    pg_failure_description Result URL (. ). pg_transaction_status = failed revoked.

    pg_error_description pg_status=error ( )

    pg_salt

    pg_sig

    YYYY-MM-DD hh:mm:ss.

    Platron, . , , , . 5 Platron 1 5 . http://www.platron.ru/do_capture.php https://www.platron.ru/do_capture.php, (. Platron). 30 . :

    pg_merchant_id

    pg_payment_id

    pg_long_record , . . .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/do_capture.php?pg_salt=123&pg_merchant_id=456&pg_payment_

    id=1234567&pg_sig=7f3af9d237952f56bd05c602d2879a3c

    XML ( POST pg_xml):

  • 35

    123

    456

    1234567

    7f3af9d237952f56bd05c602d2879a3c

    XML :

    9865

    ok

    5e1af9d237952f56bd05c602d28704ac

    :

    pg_status . ok, . Capture URL . error .

    pg_error_description pg_status=error

    pg_salt

    pg_sig

    ( ) , (, ). . , . , . , http://www.platron.ru/revoke.php https://www.platron.ru/revoke.php. (. Platron). 30 . ( ):

    pg_merchant_id

    pg_payment_id

    pg_refund_amount . 0, .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/revoke.php?pg_salt=123&pg_merchant_id=456&pg_payment_id=1

    234567&pg_refund_amount=800&pg_sig=6dd2a9d237952f56bd05c602d2872af8

    XML ( POST pg_xml):

  • 36

    123

    456

    1234567

    800

    6dd2a9d237952f56bd05c602d2872af8

    XML :

    9865

    ok

    48caf9d237952f56bd05c602d28762da

    :

    9865

    error

    490

    this transaction cant be

    revoked

    4df0f9d237952f56bd05c602d2873ed0

    :

    pg_status .

    pg_error_code

    pg_error_description

    pg_salt

    pg_sig

    , . :

    , ( , WebMoney YandexMoney),

    ( ) Contact.

    , . , .

  • 37

    , http://www.platron.ru/create_refund_request.php https://www.platron.ru/ create_refund_request.php. (. Platron). 30 . :

    1. , (YANDEXMONEY, RBKMONEY, MOBW):

    pg_merchant_id

    pg_payment_id

    pg_comment

    pg_refund_amount . 0, .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/create_refund_request.php?pg_salt=sdasdasd&pg_merchant_id

    =243&pg_payment_id=1172121&pg_comment=+++&pg_refund_

    amount=100&pg_sig=149b5b52ab0b5ebfa9693910769bc222

    XML ( POST pg_xml):

    sdasdasd

    243

    1172121

    100

    149b5b52ab0b5ebfa9693910769bc222

    2. , , 2

    a. ( )

    pg_merchant_id

    pg_payment_id

    pg_comment

    pg_payout_system ( MOBILEPHONE_O)

    pg_account

    pg_refund_amount . 0,

  • 38

    .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/create_refund_request.php?pg_salt=erewrwer&pg_merchant_id

    =254&pg_payment_id=1166045&pg_payout_system=MOBILEPHONE_O&pg_account=79031067834

    &pg_comment=+++&pg_refund_amount=100&pg_sig=17afcf9e

    7f84a651ba29f2903f133314

    XML ( POST pg_xml):

    erewrwer

    254

    1166045

    MOBILEPHONE_O

    79031067834

    100

    17afcf9e7f84a651ba29f2903f133314

    b. Contact

    pg_merchant_id

    pg_payment_id

    pg_comment

    pg_payout_system ( Contact CONTACT_O)

    pg_destination_code Contact

    pg_fio

    pg_refund_amount . 0, .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/create_refund_request.php?pg_salt=edwedwd&pg_merchant_id=

    254&pg_payment_id=1166045&pg_payout_system=CONTACT_O&pg_destination_code=xxxx&pg

    _fio=++&pg_comment=+++&pg_r

    efund_amount=100&pg_sig=ccfe7190cd89972a17e489fda7257c41

    XML ( POST pg_xml):

  • 39

    edwedwd

    254

    1166045

    CONTACT_O

    xxxx

    100

    ccfe7190cd89972a17e489fda7257c41

    c. .

    pg_merchant_id

    pg_payment_id

    pg_comment

    pg_payout_system ( . YANDEXMONEY_O)

    pg_destination_account . 16

    pg_refund_amount . 0, .

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/create_refund_request.php?pg_salt=edwedwd&pg_merchant_id=

    254&pg_payment_id=1166045&pg_payout_system=YANDEXMONEY_O&pg_destination_account=

    xxxx&pg_comment=+++&pg_refund_amount=100&pg_sig=6ffe

    7190cd89972a17e489fda7257c82

    XML ( POST pg_xml):

    edwedwd

    254

    1166045

    YANDEXMONEY_O

    xxxx

    100

    6ffe7190cd89972a17e489fda7257c82

  • 40

    (. ).

    , . Platron ( ). , , . , . http://www.platron.ru/cancel.php https://www.platron.ru/cancel.php. (. Platron). 30 . ( ):

    pg_merchant_id

    pg_payment_id

    pg_salt

    pg_sig

    GET :

    https://www.platron.ru/cancel.php?pg_salt=123&pg_merchant_id=456&pg_payment_id=1

    234567&pg_sig=628e300c3204c8ee398d878a5109b520

    XML ( POST pg_xml):

    123

    456

    1234567

    628e300c3204c8ee398d878a5109b520

    XML :

    9865

    ok

    48caf9d237952f56bd05c602d28762da

    :

    9865

    error

  • 41

    200

    transaction not found

    ac08f9d237952f5bc4e5c602d2873481

    :

    pg_status .

    pg_error_code

    pg_error_description

    pg_salt

    pg_sig

    ok , . , , , . , (, TRANSCRED), Platron . .

    . , , . , . www.azid.ru, https://www.azid.ru/control/nodes.php , , . https://www.platron.ru/create_payout.php POST:

    node_id

    token sha1("from="+node_id+";to="+to_node_id+";"+secret_key),

    node_id , , to_node_id , , to_node_id=2, secret_key , .

    verifier_node_id verifier_node_id=1 , signature_for_verifier

    signature_for_verifier , verifier_node_id. : md5(node_id+;+to_node_id+;+verifier_node_id+;+sha1(token_for_azid)) node_id to_node_id=2 (platron.ru)

    verifier_node_id=1 (azid.ru)

    token_for_azid , azid.ru

  • 42

    .

    amount

    description

    payout_system . CONTACT_O YANDEXMONEY_O.

    contract_id , . https://www.platron.ru/admin/merchants.php. , , .

    . , pg_ (destination_code fio CONTACT_O destination_account YANDEXMONEY_O).

    verifier_node_id signature_for_verifier . . json :

    error_code .

    2 ( token signature_for_verifier);

    1 ;

    0 .

    payout_id ( ). .

    error_description ( )

    : {

    error_code: 0, payout_id: 12345 }

    : {

    error_code: 2, error_description: Authentification failed }

    . . , , . . https://www.platron.ru/admin/moneyback_transactions.php (. ).

    , , https://www.platron.ru/get_payout_status.php , GET:

    node_id

  • 43

    token .

    payout_id , (. ).

    json :

    error_code .

    2 ( token);

    1 ;

    0 .

    status ( ). :

    pending: ok: received: canceled: revoked:

    error_description ( )

    : {

    error_code: 0, status: received }

    , . https://www.platron.ru/cancel_payout.php , POST:

    node_id

    token .

    payout_id , (. ).

    : {

    error_code: 0, payout_id: 12345 status: revoked }

    : {

    error_code: 2, error_description: Authentification failed }

    :

    partial , , . pending.

  • 44

    pending . ok failed.

    ok . revoked.

    failed . .

    revoked , . .

    , , .

    , . .

    (

    pg_payment_system)

    ( Check

    URL)

    (pg_lifetim

    e)

    (

    pg_can_rej

    ect=1)

    WEBMONEYR WebMoney, R-

    RUR

    Platron,

    check

    Online,

    refund

    WEBMONEYZ WebMoney, Z-

    USD

    Platron,

    check

    Online,

    refund

    WEBMONEYE

    WebMoney, E-

    EUR

    Platron,

    check

    Online,

    refund

    WEBMONEYRBANK

    WebMoney, R-

    RUR

    Platron,

    check

    Online,

    refund

    YANDEXMONEY .

    RUR

    Platron,

    check

    Online,

    refund

    MOBW / QIWI

    RUR ,

    QIWI QIWI RUR Online,

    MONEYMAILRU @mail.ru

    RUR

    Platron,

    check

    ,

    W1RUR

    RUR

    Platron,

    check

    ,

    W1USD

    USD

    Platron,

    check

    ,

    PAYPALUSD PAYPAL USD online

    PAYPALEUR PAYPAL EUR online

  • 45

    MONEYMAIL MoneyMail

    RUR

    RBKMONEY RbkMoney RUR

    Platron,

    check

    ,

    INTELLECTMONEY Intellectmoney

    RUR

    Platron,

    check

    ,

    TRANSCRED

    RUR

    Platron, reversal

    online,

    MASTERBANKCARD

    RUR

    Platron, reversal

    online,

    RUSSIANSTANDARD

    RUR

    Platron, reversal

    online,

    RAIFFEISEN

    RUR

    Platron, reversal

    online,

    PSCB

    -

    RUR online,

    BANKCARDPRU

    RUR

    ,

    TINKOFFBANKCARD

    RUR

    Platron, reversal

    online,

    EUROSET RUR

    Platron,

    check

    ,

    EUROPLAT Rapida

    RUR

    Platron,

    check

    ,

    SVYAZNOY Rapida

    RUR

    Platron,

    check

    ,

    ELECSNET

    RUR

    Platron,

    check

    ,

    OSMP / QIWI

    RUR

    OSMP-II

    / QIWI

    RUR

    ,

    UNIKASSA

    RUR

    Platron,

    check

    ,

    COMEPAY ComePay

    RUR Platron,

    ,

  • 46

    check

    PINPAY PinPay Express

    RUR

    Platron,

    check

    ,

    ESGP ESGP

    RUR

    Platron,

    check

    ,

    PETROCOMMERCE

    RUR

    Platron,

    check

    ,

    CYBERPLAT_

    CONTACT

    CyberPlat

    RUR

    Platron,

    check

    ,

    CONTACT

    RUR

    Platron,

    check

    ,

    MASTERBANK

    -

    RUR

    Platron,

    check

    ,

    BANKTRANSFER

    RUR

    ,

    BANKTRANSFERUSD

    USD

    ,

    BANKTRANSFEREUR

    EUR

    ,

    CASH

    ( EUROSET,

    ELECSNET,

    OSMP, OSMP-

    II, UNIKASSA,

    COMEPAY, CONTACT,

    MASTERBAN

    K, PINPAY, SVYAZNOY,

    EUROPLAT,

    PETROCOMMERCE,

    CYBERPLAT_

    CONTACT)

    RUR

    ,

    BEELINEMK

    RUR

    ,

    RURU

    RUR

    ,

    INPLATMTS INPLATMEGAFON

    , , 2

    RUR

    Platron,

    check

    ,

    MTSMK

    MEGAFONMK

    RUR

    ,

    MOBILEPHONE

    (

    RUR

    ,

  • 47

    )

    ALFACLICK - -

    RUR

    ,

    FAKTURA - Faktura

    RUR

    ,

    PSB

    -

    RUR

    Platron,

    check

    ,

    HANDYBANK

    - Handy

    RUR Online,

    refund

    VTB24 24

    RUR

    Platron,

    check

    ,

    RUSSIANSTANDARDIB

    RUR

    Platron,

    check

    ,

    TEST

    ,

    ,

    TESTCARD

    ,

    online

    , (init_payment.php), .

    CONTACT index

    display_dest_code

    MASTERBANK index

    ( pg_currency)

    RUR

    USD

    EUR

  • 48

    Platron

    100 *

    101

    110

    120

    200

    340

    350

    360

    400

    420

    490

    600

    700

    701

    711

    1000 ( )

    * , .

    ,

    0 ( )

    1

    2

    3

    4

    5

    40

    50

    100

    101

    300

    301

    302

    303 CVV2/CVC2

    304

    305

    306

    310

    320 fraud

    321 3ds

  • 49

    329

    330

    350

    351

    352

    353

    354

    389

    390

    391

    400 fraud-

    410

    Platron. , .

    . . . . . Platron, . .

    pg_order_id

    Check URL

    Result URL

    . , , / . online , . . , Platron. , . Platron . Platron, / .

    pg_order_id

    Check URL

    Result URL

    . , , , (), / . online , .

  • 50

    . , ( ) , Platron. Platron . ( Check URL), ( Result URL). Success URL Failure URL , . Success URL , Platron.

    pg_order_id

    Check URL

    Result URL

    . , , , , , , Platron. . , , . Platron AUTOGET AUTOPOST.

    pg_order_id

    Check URL

    Result URL

    e-mail, . 0:10 . :

    X-Merchant-ID: Merchant ID, (: 14)

    X-Registry-Date: , , -- (: 2009-12-02)

    [email protected]

    : Platron report for merchant # [--]

    , , . . , . , . .

  • 51

    order_id ,

    pg_payment_id

    BILLNUMBER, , Platron.

    op_date op_time type :

    "pay" , "ref" ( , ) rev reversal mb ( ) rev_mb

    payment_system

    ( ).

    payment_type (direct transit)

    : direct , transit Platron

    bill_amount

    , , ,

    bill_cur_symbol ,

    (RUR, EUR, USD)

    amount , pg_commission

    Platron .

    ps_commission

    (, type=transit)

    to_pay .

    currency (RUR, EUR, USD)

    , .

    : order_id pg_payment_id op_date op_time type payment_system payment_type bill_amount bill_cur_symbol amount pg_commission ps_commission to_pay currency

    289 79004 02.12.09 13:32:56 pay WEBMONEYE direct 0.13 EUR 0.1300 0.0003 0.0000 0.13 EUR

    291 79212 02.12.09 19:39:41 pay TEST transit 10.00 RUR 10.0000 0.0000 10.00 RUR

    293 79216 02.12.09 19:42:10 pay TEST transit 0.30 USD 10.0000 0.0000 10.00 RUR 293 79216 02.12.09 19:42:10 ref TEST transit -10 RUR -10.0000 0.0000 -10.00 RUR

    76392 78930 02.12.09 00:08:22 pay RAIFFEISEN direct 35.87 USD 1076.1400 2.5951

    35.5100 1073.54 RUR 76394 78932 02.12.09 00:15:02 pay RAIFFEISEN direct 994.26 RUR 994.2600 2.3976

    32.8100 991.86 RUR