MerchantManual Alfa 20140414 Ru

Merchant Manual (RU)1 2 3 4

4.1 3d secure4.2 3d secure

5 6 WebService-

6.1 , 6.1.1 6.1.2 6.1.3 6.1.4 6.1.5 6.1.6 3DS

6.2 , 6.2.1 6.2.2 6.2.3 6.2.4 6.2.5 6.2.6 6.2.7 3DS

7 REST7.1 ,

7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 3DS

7.2 , 7.2.1 c 7.2.2 o o 7.2.3 7.2.4 7.2.5 7.2.6 7.2.7 3DS

8 Callback-9

9.1 9.2

9.2.1 9.2.2 9.2.3

9.2.3.1 9.3

9.3.1 9.3.2 9.3.3

10 11 12 1.

12.1 12.2 . 12.3

12.3.1 , WebService-12.3.1.1 12.3.1.2 12.3.1.3 12.3.1.4

12.3.2 , REST

12.3.2.1 12.3.2.2 12.3.2.3 12.3.2.4

13 2. "- "13.1 13.2 13.3 -13.4 -13.5 13.6 13.7 -

13.7.1 WebService13.7.2 REST

14 3. 14.1 14.2

15 4. - actionCode ( )

.

- (), -. - VISA MasterCard.- , . (, Visa MasterCard) - () , , .- , .3D Secure Visa, -.SecureCode MasterCard, -. 3D Secure. 3DSecure SecureCode.Merchant Plugin Interface (MPI) 3D Secure SecureCode, ACS Access Control Server, 3D Secure, -. HTML-, . , . , , expiration date,CVC. - . - ( , ) , - . . -- /, , . /, , . () ( ). . (Reversal) - . , . (Refund) - () . .

:

1.

1. 2.

HTML-, CSS , . " ".

:

. API. . API

3d secure.

3d secure

1. 2.

3.

4. 5. 6.

:

. , . , , , URL . URL, . redirect URL, 3. URL

6. 7. 8. 9.

10. 11. 12. 13.

14. 15. 16.

17. 18. 19. 20.

URL 3DSecure (SecureCode). redirect ACS ( 3DS) ACS ( -)ACS , ACSACS ( ) redirect URL . URL , () , URL ( ) . ( ) .

18 19 , .

3d secure

:

1. 2.

3.

4. 5. 6. 7. 8. 9.

10. 11. 12. 13.

1. 2.

. , . , , , URL . URL, . redirect URL, 3. URL URL ( ..) , URL ( ) . ( )

20 ( URL ), .

. ( 18-19).

.20 on-line . ( ), off-line .

(AF)

, :

2, 3 - ,19, 20 - 11 12 - .

, .. , - . , API 2 :

2 API:

WebService- (SOAP) REST

: 20 . .

1. .2. .3. .4. :

REST \ web-

5. , . , .6. .7. .

8. ( 3DS-, SSL-).9. .10. -.

WebService- (WSDL) , . . " ".

, , . , WS-Security, userName token. :

aa

123456

( ) . .

Error code ( ) = 0, ( error code ). getOrderStatus getOrderStatusExtended.

,

registerOrder, WSDL . , .

:

merchantOrderNumber AN..32 () ,

amount N..20

currency N3 ISO 4217. , 810 ().

returnUrl AN..512 ,

params *

description AN..512

language A2 ISO 639-1. , , (default language).

pageView A..7 pageView - (pageView=MOBILE) (pageView=DESKTOP). . , , pageView=DESKTOP.

clientId AN..255 () . . , .

sessionTimeoutSecs N...9 . 1200 . , (1200 - 20).

* . .**

. N , N Params, name , value :

name AN..20

value AN..1024

** orderNumber description ( 99 , %, +, \r \n)

:

orderId AN..64 . . , , ErrorCode.

formUrl AN..512 URL , . , , ErrorCode.

errorCode N3

errorMessage AN..512 , Language .

:

0

1

1

3

4

4

4 URL

5 ''

5

5

5

7

:

http://engine.paymentgate.ru/webservices/merchant

- Optional: - http://example.ru?page=result - Zero or more repetitions: - - Optional: - 666

:

http://schemas.xmlsoap.org/soap/envelope/ http://engine.paymentgate.ru/webservices/merchant https://test.paymentgate.ru/testpayment/merchants/rbs/mobile_payment_ru.html?mdOrder=05fcbc62-7ee6-4f1a-b3d5-6ca41a982283

reverseOrder. , ( - ). .

, .

:

orderId AN..64 . .

language A2 ISO 639-1. , , . .

:

errorCode N3 .


( errorCode):

0

5

5

5 [orderId]

6

7

7

:

- Zero or more repetitions: -

:

refundOrder.

. , . 1 , .

, .

:

orderId AN..64 . .

refundAmount N..5 . .


:

errorCode N3 .


( errorCode):

0

5

5

5 [orderId]

5

6

7

7

7

:



:

getOrderStatus.

:

orderId AN..64 . .


:

orderStatus N2 . , . , .

errorCode N3 .


orderNumber AN..32 ()

pan N..19 , . .

expiration N6 YYYYMM. .

cardholderName A..64 . .

amount N..20 ( )

currency N3 ISO 4217. , 810 ().

approvalCode AN6 (6 ), . .

authCode N3

ip NS..15 IP ,

date ANS

orderDesctiption AN..512 ,

actionCodeDesctiption AN..512 , Language .

bindingInfo:

clientId AN..255 () , . .

bindingId AN..255 . .

OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( errorCode):

0

2

5

5

5 [orderId]

6

7

:

:

getOrderStatusExtended.

:

orderId AN..64 * .


merchantOrderNumber AN..32 * () .

* orderId, merchantOrderNumber. , orderId .

3 . , getOrderStatusExtended, .

01, 02, 03: getOrderStatusExtended.



actionCode N3 .

actionCodeDescription AN..512 , Language .

errorCode N3 .


amount N..20 ( )

currency N3 ISO 4217. , 810 ().

date ANS .

orderDescription AN..512 ,

ip AN..20 IP

cardAuthInfo ( , secureAuthInfo maskedPan, expiration, cardholderName approvalCode):

maskedPan N..19 , . .



approvalCode AN6 . (6 ), . .

secureAuthInfo ( eci threeDSInfo, cavv xid):

eci N..4 . .

cavv ANS..200 . .

xid ANS..80 . .

bindingInfo ( clientId bindingId):



02, 03: getOrderStatusExtended 02 , , , .

authDateTime ANS /

authRefNum AN..24 Reference number

terminalId AN..10 Id

03: getOrderStatusExtended 03, , , .

paymentAmountInfo ( approvedAmount, depositedAmount,refundedAmount paymentState):

approvedAmount N..20 , ( )

depositedAmount N..20 ,

refundedAmount N..20

paymentState N2

bankInfo ( bankName,bankCountryCode bankCountryName):

bankName AN..200 -

bankCountryCode AN..4 -

bankCountryName AN..160 - , language , , ,

OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( errorCode):

0

1 [orderId] [orderNumber]

5

5

6

7

:


- Optional: -

:

http://schemas.xmlsoap.org/soap/envelope/ http://engine.paymentgate.ru/webservices/merchant 2013-11-13T16:51:02.898+04:00 111113 111111111111

3DS 3DS verifyEnrollment.

:

pan N12...19

:

errorCode N3 .

errorMessage AN..512 .

isEnrolled A1 3DS. : Y, N, U.

emitterName AN..160 -.

emitterCountryCode AN..4 -.

( ErrorCode):

0

1

1 , 13 19

5

5

6

7

:

4111111111111111

:

,

registerOrderPreAuth. , c

.

:

merchantOrderNumber AN..32 () ,

amount N..20 ( )

currency N3 ISO 4217. , 810 ().

returnUrl AN..512 ,

params .*

description AN..512

language A2 ISO 639-1. , , (default language).


clientId AN..255 () . . , .


. * . **

. N , N Params, name , value :

name AN..20

value AN..1024


:

orderId AN..64 . . , , ErrorCode.

formUrl AN..512 URL , . , , ErrorCode.

errorCode N3 .


( errorCode):

0

1

1

3

4

4

4 URL

5

5 ''

5

5

5

7 ( )

:


- Optional: - http://ya.ru - Zero or more repetitions: - - Optional: - 7777

:

http://schemas.xmlsoap.org/soap/envelope/ http://engine.paymentgate.ru/webservices/merchant

https://test.paymentgate.ru/testpayment/merchants/rbs/payment_ru.html?mdOrder=5e5dc6bd-dee3-4c96-849a-09f3f575f4b6

depositOrder. , .

:

orderId AN..64 . .

depositAmount N..5 . . 1 .


:

errorCode N3 .


!!! "amount", .

( errorCode):

0

5

5

5

5

6

6 [orderId]

7

7

:


:

reverseOrder. -, . , ( - ). .

.

:

orderId AN..64 . .


:

errorCode N3 .


( errorCode):

0

5

5

5 [orderId]

6

7

7

:


:

refundOrder. . , . 1 , .

, .

:

orderId AN..64 . .

refundAmount N..5 . .


:

errorCode N3 .


( errorCode):

0

5

5

5 [orderId]

5

6

7

7

7

:


:

getOrderStatus.

:

orderId AN..64 . .


:


errorCode N3 .



pan N..19 , . .



amount N..20 ( )

currency N3 ISO 4217. , 810 ().

approvalCode AN6 (6 ), . .

authCode N3

ip NS..15 IP ,

date ANS

orderDesctiption AN..512 ,

actionCodeDesctiption AN..512 , Language .

bindingInfo:



OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( errorCode):

0

2

3

5

5

5 [orderId]

6

7

:

:


:

orderId AN..64 * .


merchantOrderNumber AN..32 * () .

* orderId, merchantOrderNumber. , orderId .





actionCode N3 .

actionCodeDescription AN..512 , Language .

errorCode N3 .


amount N..20 ( )

currency N3 ISO 4217. , 810 ().

date ANS .


ip AN..20 IP

cardAuthInfo ( , secureAuthInfo maskedPan, expiration, cardholderName approvalCode):






eci N..4 . .

cavv ANS..200 . .

xid ANS..80 . .

bindingInfo ( clientId bindingId):




authDateTime ANS /








paymentState N2


bankName AN..200 -



OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( errorCode):

0


5

5

6

7

:


- Optional: -

:

http://schemas.xmlsoap.org/soap/envelope/ http://engine.paymentgate.ru/webservices/merchant 2013-11-13T16:51:02.898+04:00 111113 111111111111


pan N12...19

errorCode N3 .





( ErrorCode):

0

1

1 , 13 19

5

5

6 .

7

:

4111111111111111

:

REST HTTP GET POST URL, - (. " "). GET POST , URL(.. url encoded).

JSON . :

{"errorCode":"12","errorMessage":"Empty amount"}

, , . :

userName AN..30 ,

password AN..30 ,

( ) . .

(UTF-8).

- REST URL-. : . , "qwe?rt%y" "qwe%0Frt%25y".http://web-developer.name/urlcode/

error code ( ) = 0, ( error code ).

getOrderStatus getOrderStatusExtended.

,

register (. " ").

.

:

userName AN..30 ,

password AN..30 ,

orderNumber AN..32 () ,

amount N..20 ( )

currency N3 ISO 4217. , 810 ().

returnUrl AN..512 ,

description AN..1024

language A2 ISO 639-1. , , (default language)


clientId AN..255 () . . , .

jsonParams AN..1024 , {"param":value,"param2":value 2}. .* .


* orderNumber description ( 99 , %, +, \r \n)

:

orderId AN..64 . . , ErrorCode.

formUrl AN..512 URL , . , ErrorCode.

errorCode N3 .


( errorCode):

:

0

1

3 ()

4

5

7

:

0

1

1 ,

1

3

4

4

4

4 URL

4

5

5 ''

5

5

5

5 [jsonParams]

7

: 4 ( ) , : , , , , URL , .

GET:

https://test.paymentgate.ru/testpayment/rest/register.do?amount=100&currency=810&language=ru&orderNumber=87654321&password=testPwd&

returnUrl=finish.html%3Flogin%3Dtest%26password%3DtestPwd& userName=test&jsonParams={"orderNumber":1234567890}&pageView=DESKTOP

POST:

amount=100&currency=810&language=ru&orderNumber=87654321&password=testPwd&

returnUrl=finish.html%3Flogin%3Dtest%26password%3DtestPwd& userName=test&jsonParams={"orderNumber":1234567890}&pageView=DESKTOP

:

{"orderId":"70906e55-7114-41d6-8332-4609dc6590f4","formUrl": "https://test.paymentgate.ru/testpayment/merchants/test/payment_ru.html?

mdOrder=70906e55-7114-41d6-8332-4609dc6590f4"}

reverse.

, .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .

:

errorCode N3 .


( errorCode):

:

0

5

6 OrderId

7

:

0

5

5

5 [orderId]

6

7

7 . : , ,

7

GET:

https://test.paymentgate.ru/testpayment/rest/reverse.do?amount=100&currency=810&language=ru&orderId=e5b59d3d-746b-4828-9da4-06f126e01b68&

password=testPwd&userName=testtest

POST:

amount=100&currency=810&language=ru&orderId=e5b59d3d-746b-4828-9da4-06f126e01b68&


:

{"errorCode":0}

refund.

, .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .

amount N..20 ( )

:

errorCode N3 .


( errorCode):

:

0

5

6 OrderId

7

:

0

5

5

5 [orderId]

6

7

7 ( )

7

GET:

https://test.paymentgate.ru/testpayment/rest/refund.do?amount=500&currency=810&language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208&


POST:

amount=500&currency=810&language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208&


:

{"errorCode":0}

getOrderStatus. .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .


:

OrderStatus N2 . , ., .

ErrorCode N3 .

ErrorMessage AN..512 , Language .

OrderNumber AN..32 ()

Pan N..19 , . .



Amount N..20 ( )

currency N3 ISO 4217. , 810 ( ).

approvalCode AN6 . (6 ), .

authCode N3

ip AN..20 IP ,

BindingInfo:



OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( ErrorCode):

0

2

5

5

5 [orderId]

6 OrderId

GET:

https://test.paymentgate.ru/testpayment/rest/getOrderStatus.do?language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208&


POST:

language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208&


:

{"expiration":"201512","approvalCode":"000000","Pan":"123456**6740", "Amount":1000,"cardholderName":"yrey rgre","OrderStatus":4,"authCode":2,

"OrderNumber":"132353464","depositAmount":500,"Ip":"127.0.0.1"}


:

userName AN..30 ,

password AN..30 ,

orderId AN..64 * . .

orderNumber AN..32 * () .


* orderId, orderNumber. , orderId.




orderStatus N2 . , . ,

actionCode N3

actionCodeDescription AN..512 , Language

errorCode N3 .

errorMessage AN..512 , Language

amount N..20 ( )

currency N3 ISO 4217. , 810 ()

date ANS


ip N.. IP

cardAuthInfo ( , secureAuthInfo pan,expiration, cardholderName approvalCode):

pan N..19 , .

expiration N6 YYYYMM.

cardholderName A..64 .



eci N..4 .

cavv ANS..200 .

xid ANS..80 .

BindingInfo ( clientId bindingId):

clientId AN..255 () , .

bindingId AN..255 .


authDateTime ANS /








paymentState N2


bankName AN..200 -



OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( errorCode):

0


2

5

5

6 OrderId

7

GET:

https://test.paymentgate.ru/testpayment/rest/getOrderStatusExtended.do?userName=login&password=password&orderId=b9054496-c65a-4975-9418-1051d101f1b9&language=ru&

merchantOrderNumber=0784sse49d0s134567890

POST:

userName=login&password=password&orderId=b9054496-c65a-4975-9418-1051d101f1b9&language=ru&


:

{"errorCode":"0","errorMessage":"","orderNumber":"0784sse49d0s134567890","orderStatus":6,

"actionCode":-2007,"actionCodeDescription":" ","amount":33000,"currency":"810",

"date":1383819429914,"orderDescription":" ", "merchantOrderParams":[{"name":"email","value":"yap"}], "attributes":[{"name":"mdOrder","value":"b9054496-c65a-4975-9418-1051d101f1b9"}], "cardAuthInfo":{"expiration":"201912","cardholderName":"Ivan", "secureAuthInfo":{"eci":6,"threeDSInfo":{"xid":"MDAwMDAwMDEzODM4MTk0MzAzMjM="}}, "pan":"411111**1111"},"terminalId":"333333"}


:

userName AN..30 (API)

password AN..30 (API)

pan N12...19

:

errorCode N3 .





( errorCode):

:

0

1

1 , 13 19

5 .

5

6 .

7 .

GET:

https://test.paymentgate.ru/testpayment/rest/verifyEnrollment.do?userName=api&password=***&pan=4111111111111111

POST:

userName=api&password=***&pan=4111111111111111

:

{"errorCode":"0","errorMessage":"","emitterName":"TEST CARD",

"emitterCountryCode":"RU","enrolled":"Y"}

,

c registerPreAuth (. " ").

. :

userName AN..30 ,

password AN..30 ,

orderNumber AN..32 () ,

amount N..20 ( )

currency N3 ISO 4217. , 810 ().

returnUrl AN..512 ,

description AN..1024



clientId AN..255 () . . , .

jsonParams AN..1024 , {"param":value,"param2":value 2}. .* .


* orderNumber description ( 99 , %, +, \r \n)

:

orderId AN..64 . . , ErrorCode.

formUrl AN..512 URL , . , ErrorCode.

errorCode N3 .


( errorCode):

:

0

1

3 ()

4

5

7

:

0

1

1 ,

1

3

4

4

4

4 URL

4

5

5 ''

5

5

5

5 [jsonParams]

7

: 4 ( ) , : , , , , URL , .

GET:

https://test.paymentgate.ru/testpayment/rest/registerPreAuth.do?amount=100&currency=810&language=ru&orderNumber=87654321&password=testPwd& returnUrl=finish.html%3Flogin%3Dtest%26password%3DtestPwd&userName=test&pageView=MOBILE

POST:

amount=100&currency=810&language=ru&orderNumber=87654321&password=testPwd& returnUrl=finish.html%3Flogin%3Dtest%26password%3DtestPwd&userName=test&pageView=MOBILE

:

{"orderId":"61351fbd-ac25-484f-b930-4d0ce4101ab7","formUrl": "https://test.paymentgate.ru/testpayment/merchants/test/mobile_payment_ru.html?

mdOrder=61351fbd-ac25-484f-b930-4d0ce4101ab7"}

o o

deposit.do

, .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .

amount N..20 ( )

!!! "amount" , .

:

errorCode N3 .


( ErrorCode):

:

0

5

6 OrderId

7

:

5

5

5

5

6

7

7

GET:

https://test.paymentgate.ru/testpayment/rest/deposit.do?amount=100&currency=810&language=ru&orderId=e5b59d3d-746b-4828-9da4-06f126e01b68&


POST:



:

{"errorCode":0}

reverse.

, .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .

:

errorCode N3 .


( ErrorCode):

:

0

5

6 OrderId

7

:

0

5

5

5 [orderId]

6

7

7 . : , ,

7

GET:

https://test.paymentgate.ru/testpayment/rest/reverse.do?amount=100&currency=810&language=ru&orderId=e5b59d3d-746b-4828-9da4-06f126e01b68&


POST:



:

{"errorCode":0}

refund.

, .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .

amount N..20 ( )

:

errorCode N3 .


( ErrorCode):

:

0

5

6 OrderId

7

:

0

5

5

5 [orderId]

6

7

7 ( )

7

GET:

https://test.paymentgate.ru/testpayment/rest/refund.do?amount=500&currency=810&language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208&

password=testPwd&userName=testtest }

POST:{amount=500&currency=810&language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208&password=testPwd&userName=testtest |

:

{"errorCode":0}

GetOrderStatus. .

:

userName AN..30 ,

password AN..30 ,

orderId AN..64 . .


:

OrderStatus N2 . , ., .

ErrorCode N3 .

ErrorMessage AN..512 , Language .

OrderNumber AN..32 ()

Pan N..19 , . .



Amount N..20 ( )

currency N3 ISO 4217. , 810 ( ).

approvalCode AN6 . (6 ), .

authCode N3

Ip AN..20 IP ,

BindingInfo:



OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( ErrorCode):

0

2

5

5

5 [orderId]

6 OrderId

GET:

https://test.paymentgate.ru/testpayment/rest/getOrderStatus.do?language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208 &password=testPwd&userName=testtest

POST:

language=ru&orderId=5e97e3fd-1d20-4b4b-a542-f5995f5e8208

&password=testPwd&userName=testtest

:

{"expiration":"201512","approvalCode":"000000","Pan":"123456**6740", "Amount":1000,"cardholderName":"yrey rgre","OrderStatus":4,"authCode":2,

"OrderNumber":"132353464","depositAmount":500,"Ip":"127.0.0.1"}


:

userName AN..30 ,

password AN..30 ,

orderId AN..64 * . .

orderNumber AN..32 * () .


* orderId, orderNumber. , orderId.




orderStatus N2 . , . ,

actionCode N3

actionCodeDescription AN..512 , Language

errorCode N3 .

errorMessage AN..512 , Language

amount N..20 ( )

currency N3 ISO 4217. , 810 ()

date ANS


ip N.. IP

cardAuthInfo ( , secureAuthInfo pan,expiration, cardholderName approvalCode):

pan N..19 , .

expiration N6 YYYYMM.

cardholderName A..64 .



eci N..4 .

cavv ANS..200 .

xid ANS..80 .

BindingInfo ( clientId bindingId):

clientId AN..255 () , .

bindingId AN..255 .


authDateTime ANS /








paymentState N2


bankName AN..200 -



OrderStatus :

0 ,

1 ( )

2

3

4

5 ACS -

6

( errorCode):

0


2

5

5

6 OrderId

7

GET:

https://test.paymentgate.ru/testpayment/rest/getOrderStatusExtended.do?userName=login&password=password&orderId=b9054496-c65a-4975-9418-1051d101f1b9&language=ru&


POST:

userName=login&password=password&orderId=b9054496-c65a-4975-9418-1051d101f1b9&language=ru&


:

{"errorCode":"0","errorMessage":"","orderNumber":"0784sse49d0s134567890","orderStatus":6,

"actionCode":-2007,"actionCodeDescription":" ","amount":33000,"currency":"810",

"date":1383819429914,"orderDescription":" ", "merchantOrderParams":[{"name":"email","value":"yap"}], "attributes":[{"name":"mdOrder","value":"b9054496-c65a-4975-9418-1051d101f1b9"}], "cardAuthInfo":{"expiration":"201912","cardholderName":"Ivan", "secureAuthInfo":{"eci":6,"threeDSInfo":{"xid":"MDAwMDAwMDEzODM4MTk0MzAzMjM="}}, "pan":"411111**1111"},"terminalId":"333333"}


:

userName AN..30 (API)

password AN..30 (API)

pan N12...19

:

errorCode N3 .





( errorCode):

0

1

1 , 13 19

5 .

5

6 .

7 .

GET:

https://test.paymentgate.ru/testpayment/rest/verifyEnrollment.do?userName=api&password=***&pan=4111111111111111

POST:

userName=api&password=***&pan=4111111111111111

:

{"errorCode":"0","errorMessage":"","emitterName":"TEST CARD",

"emitterCountryCode":"RU","enrolled":"Y"}

Callback- , .

:

:

(DEPOSITED); (REVERSED); (REFUNDED).

:

(APPROVED); (DEPOSITED); (REVERSED); (REFUNDED) .

URL, callback:

:

id ANS36 . .

merchantOrder AN..32 () ,

operation N..9 :

approved - ;deposited - ;reversed - ;refunded - .

status N1 , operation (1 - , 0 - )

URL:

zip-, js-, css- . .

7-zip.

xhtml-, DTD

- (, , ). , ( - , http:host/images/test.jpg

- ).images/test.jpg

*!!!!!!!!! * XHTML - , http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd

.

:

payment_.html errors_.html locale - , ru en . ISO 639-1

, :

mobile_payment_.html ;mobile_errors_.html . locale - , ru en . ISO 639-1

, , , pageView (. " " " ")

( , ) (UTF-8).

, .

payment_.html,

- mobile_payment_.html,

- ISO 639-1 (, ru , en - ).

:

:

$(document).payment({ });

:

$(document).payment({ language: "ru", messageAjaxError: " . .",

messageTimeRemaining: " #MIN#:#SEC#",

visualValidationEnabled: true });

:

language , messageAjaxError Ajax ( )messageTimeRemaining . #MIN# #SEC#, , .visualValidationEnabled - / . true - , - . false ( ), - .

, , , .

,

,

,

:

hidden- . language .

:

1 -

2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - / 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022

( )

(Cardholder name)

cvc/cvv/cid -

.

, :

:

, (, )

, , .

, .

, ( )

:

-

-

- ( description)

.

errors_.html,

mobile_errors_.html,

- (, ru , en - , ISO 639-1).

:

var lang = "";

- (, ru , en - , ISO 639-1).

, , .

:

- (, ru , en - , ISO 639-1).

, (, , ).

, , , .

(WSDL) .https://test.paymentgate.ru/testpayment/webservices/merchant-ws?wsdl

URL REST:

URL

https://test.paymentgate.ru/testpayment/rest/register.do

https://test.paymentgate.ru/testpayment/rest/registerPreAuth.do

https://test.paymentgate.ru/testpayment/rest/deposit.do

https://test.paymentgate.ru/testpayment/rest/reverse.do

https://test.paymentgate.ru/testpayment/rest/refund.do

https://test.paymentgate.ru/testpayment/rest/getOrderStatus.do

https://test.paymentgate.ru/testpayment/rest/getOrderStatusExtended.do

3DS https://test.paymentgate.ru/testpayment/rest/verifyEnrollment.do

https://test.paymentgate.ru/testpayment/rest/paymentOrderBinding.do

https://test.paymentgate.ru/testpayment/rest/unBindCard.do

https://test.paymentgate.ru/testpayment/rest/bindCard.do

https://test.paymentgate.ru/testpayment/rest/getBindings.do

Cardholder name 2 . , 3d Secure (veres=y, pares=y a) ACS 12345678. /Use two or more words in Roman letters as the name of the cardholder. For cards involeved into 3d Secure ( ) ACS code isveres=y, pares=y or a12345678:

pan: 4111 1111 1111 1111 exp date: 2015/12

cvv2: 1233dsecure: veres=y, pares=y

pan: 5100 0000 0000 0008 exp date: 2015/08


pan: 6011 0000 0000 0004 exp date: 2015/12


pan: 6390 0200 0000 000003 exp date: 2015/12

cvv2: 123( )

3dsecure: veres=y, pares=a

pan: 5555 5555 5555 5599 exp date: 2015/12

cvv2: 1233dsecure: veres=n

pan: 4444 0000 0000 1111 exp date: 2015/12

cvv2: 1233dsecure: veres=n

, /Cards returning errors:

pan: 5555 5555 5555 5557 exp date: 2015/12

cvv2: 1233dsecure: veres=y, pares=u

pan: 4444 3333 2222 1111 exp date: 2015/12

cvv2: 1233dsecure: veres=y, pares=u

Declined. PaRes status is U (-2011)

pan: 4000 0000 0000 0002 exp date: 2015/12

cvv2: 1233dsecure: veres=u

pan: 5555 5555 4444 4442 exp date: 2015/12

cvv2: 1233dsecure: veres=u

Declined. VeRes status is U (-2016)

pan: 4444 4444 4444 4422 exp date: 2015/12

cvv2: 123

Invalid message format (913)

pan: 4444 4444 4444 4455 exp date: 2015/12

cvv2: 123

Card limitations exceeded (902)

pan: 4444 4444 4444 3333 exp date: 2015/12

cvv2: 123

Limit exceeded (123)

pan: 4444 4444 4444 6666 exp date: 2015/12

cvv2: 123

BLOCKED_BY_LIMIT (-20010)

pan: 4444 4444 1111 1111 exp date: 2015/12

cvv2: 123

Network refused transaction (5)

pan: 4444 4444 9999 9999 exp date: 2015/12

cvv2: 123

TDSEC_COMM_ERROR (151017)

pan: 5432 5432 5432 5430 exp date: 2018/08

cvv2: 521

INSUFFICIENT_FUNDS (116)

1. 1 2 . 3

3.1 , WebService-3.1.1 3.1.2 3.1.3 3.1.4

3.2 , REST3.2.1 3.2.2 3.2.3 3.2.4

id (, ). 2 : .

, , id, , CVC/ CVV.

( ) , , id - .

.

. , .

:

id="formBinding". - CSS "display: none;". name="bindingId". : , , . VC/CVV name="cvc". "": id="buttonBindingPayment". CVC/CVV "" class="rbs_hidden". , CSS "display:none;".

:

: CVC2/CVV2/CID :( )

, WebService-

paymentOrderBinding.

:

mdOrder ANS36 . .

bindingId ANS36 . .

params .*


ip NS..15 ip

cvc N4 CVC. , " CVC".

email ANS..* Email

* . .**

. N ,

N Params, name , value :

name AN..20

value AN..1024


:

redirect ANS..* URL ( SSL)/URL ACS ( 3DS)

info ANS..*

errorCode N1

errorMessage ANS..* ( )

acsUrl ANS..* ( 3DS ) URL ACS

paReq ANS..* ( 3DS ) Payment Authentication Request

( errorCode):

0

1 CVC2/CVV2 , CVC

1 CVC

1 [mdOrder]

1 [bindingId]

1

1

2

2

5

5

5

7

:

7

:

fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

:

bindCard.

:

bindingId ANS36 .

:

errorCode N1

errorMessage ANS..* ( )

( errorCode):

0

2 ( )

2

5

5

7

:

fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

:

getBindings.

:


:

errorCode N1

errorMessage ANS..* ()

binding ( bindingId, maskedPan expiryDate):



expiryDate N6 YYYYMM. .

( errorCode):

0

1 [clientId]

2

5

5

7

:

:

, REST

paymentOrderBinding (. " ").

:

userName AN..30 ,

password AN..30 ,

mdOrder AN..64 . .


cvc N..3 CVC . , " CVC".


:

redirect ANS..* ( SSL ) URL,

info ANS..*

success N1

error AN..* ( )

acsUrl ANS..* ( 3DS ) URL ACS

paReq ANS..* ( 3DS ) Payment Authentication Request

termUrl ANS..* ( 3DS ) URL ACS

( success):

0

1 CVC2/CVV2, CVC

1 CVC

1

2

2

5

5 , ,

7

POST:

userName=username&mdOrder=65401edc-3fa1-4112-87fd-a569ca69fb6a&

bindingId=41954212-70a7-4eae-8430-90c1a87beda7&password=testPwd

:

{"info":" , ...","redirect":"finish.html?login=username&

password=testPwd&orderId=65401edc-3fa1-4112-87fd-a569ca69fb6a","success":0}

, , unBindCard (. " ").

:

userName AN..30 , .

password AN..30 , .


:

errorCode N3 .


( errorCode):

0

2 (

2

5

5

7

GET:

https://test.paymentgate.ru/testpayment/rest/unBindCard.do?userName=binding_api&password=testPwd&bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

POST:

userName=binding_api&password=testPwd&bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

:

{"errorCode":"2","errorMessage":"Binging isn't active"}

bindCard (. " ").

:

userName AN..30 , .

password AN..30 , .


:

errorCode N3 .


( errorCode):

0

2 ( )

2

5

5

7

GET:

https://test.paymentgate.ru/testpayment/rest/bindCard.do?userName=binding_api&password=testPwd&bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

POST:

userName=binding_api&password=testPwd&bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

:

{"errorCode":"2","errorMessage":"Binding is active"}

getBindings (. " ").

:


:

errorCode N1

errorMessage ANS..* ()

binding ( bindingId, maskedPan expiryDate):



expiryDate N6 YYYYMM. .

( errorCode):

0

1 [clientId]

2

5

5

7

GET:

https://test.paymentgate.ru/testpayment/rest/getBindings.do?userName=binding_api&password=testPwd&clientId=client

POST:

userName=binding_api&password=testPwd&clientId=client

:

{"bindings":[{"bindingId":"fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc", "maskedPan":"4000 00** **** **02","expiryDate":"201512"}],"errorCode":"0",

"errorMessage":""}

2. "- "1 2 3 -4 -5 6 7 -

7.1 WebService7.2 REST

PayByClick . - .

2 -: .

PayByClick - -.

.

.

.

.

( ).

, (reversal refund).

e-invoicing.

- ( -)

( -)

( - )

PayByClick ( - PayByClick)

Back-end: Gemini, E-Invoicing, .

- :

( ), ( ).

1. .

2. , .

3. ID URL . , 4-5. , URL 7.

4. redirect URL, 3.

5. URL, .

6. : , PayByClick.

7. : ID , URL (BackURL).

8. PayByClick ID ( WS ).

9. .

10-29. .

30. PayByClick ( WSInvoiceConfirm).

31. e-invoicing (. ).

32. WSInvoiceConfirm .

33. PayByClick URL , 6 .

34. BackURL .

35. java- ( DEPOSITED , APPROVED DECLINED)

36. ,

37.

1. . REST/ SOAP,

https://test.paymentgate.ru/testpayment/merchants/alfa-test/test.html

2 :

: , , . , : http://bpc.ru

2. "" "" ( - )

:https://test.paymentgate.ru/testpayment/merchants/alfa-test/payment_ru.html?mdOrder=

3. , " "

https://testjmb.alfabank.ru/PayByClick/login.jsp :

4. / : 1821363/000000 , :

5. 00000000:

: , 987.

, , ( returnUrl ( REST/ SOAP), ( ))

. , (getOrderStatus) , APPROVED ( ) DEPOSITED ( ) - .

, " ", - " .

-

WebService paymentOrderOtherWay .

, .

:

orderId ANS36 ,

paymentWay ANS..*

ip AS..15 IP


:

errorCode N1

errorMessage ANS..*

info ANS..*

redirect ANS..*

( errorCode):

0

1 [orderId]

1 [paymentWay]

2

5

5

5

5 paymentWay

5

:


:

http://schemas.xmlsoap.org/soap/envelope/ http://engine.paymentgate.ru/webservices/merchant

1 [orderId]

1 [paymentWay]

2

5

5

5

5 paymentWay

5

POST:

password=111111&userName=987&language=ru&MDORDER=c96a734c-e2c9-429c-8fda-aaa0030c8a92&paymentWay=ALFA_ALFACLICK

:

{"redirect":"http://testjmb.alfabank.ru/PayByClick/login.jsp?orderId=b37da970-e2b8-4729-a196-b4c2ab5bb401&backUrl=+","info":"Your orderis proceeded, redirecting...","errorCode":0}

3.

, .

, , .

1 TICKET /

2 LANGUAGE

3 USER_FIRST_NAME ,

4 USER_LAST_NAME ,

5 USER_MOBILE_PHONE ,

6 USER_HOME_PHONE ,

7 USER_EMAIL ,

8 S {N}-BDATE N

9 S {N}-EDATE N

10 S{N}-BLOCATIONCOUN

N,

11 S{N}-ELOCATIONCOUN

N,

12 S{N}-BLOCATIONCODE

N,

13 S{N}-ELOCATIONCODE

N,

14 S{N}-BLOCATIONCITY

N,

15 S{N}-ELOCATIONCITY

N,

16 S {N}-FLIGHTNUMBER N

17 P {M}-FIRSTNAME M

18 P {M}-LASTNAME M

:S{N}- . . {N} 1 99,.. S1 S99.

P{N}- . {N} 1 99, .. P1 P99

:

1 TICKET 5WY8FZ

2 LANGUAGE RU

3 USER_FIRST_NAME Maxim

4 USER_LAST_NAME Zhukoveckiy

5 USER_MOBILE_PHONE +7 9055457319

6 USER_HOME_PHONE null

7 USER_EMAIL [email protected]

8 S {N}-BDATE Tuesday , January 22, 2013 6:40:00 AM

9 S {N}-EDATE Tuesday , January 22, 2013 7:25:00 AM

10 S {N}-BLOCATIONCOUN

11 S {N}-ELOCATIONCOUN

12 S {N}-BLOCATIONCODE PEE

13 S {N}-ELOCATIONCODE LED

14 S {N}-BLOCATIONCITY

15 S {N}-ELOCATIONCITY -

16 S {N}-FLIGHTNUMBER 712

17 P {M}-FIRSTNAME Maxim

18 P {M}-LASTNAME Zhukoveckiy

4. - actionCode () , . :

Action code - digital code of a result received after a client addressed to the system. The following codes exist in the system:

Actioncode

error_id error_message / Description

-20010 -20010 BLOCKED_BY_LIMIT , - / Transaction is rejected since the amount exceeds limits specified by the Issuing bank

-9000 -9000 Started / State of transaction start

-3003 3003- / Unkown

-2102 -2102

/ Regect by a passanger name

-2101 -2101 e-mail e-mail / Reject by email

-2019 -2019 Decline by iReq in PARes PARes iReq, / PARes from the issuing bank contains iReq, which caused the payment rejection

-2018 -2018 Declined. DS connectiontimeout

Directory server Visa MasterCard , (VeReq) . . / There is no access to Directory server Visa or MaterCard or a connection error occured aftercard involvement request (VeReq). This is an error of interacion between payment gate and IPSservers due to technical problems on the side of IPS servers.

-2017 -2017 . VERes- "Y"

. VERes- "Y"/ Rejected. VERes status is not "Y"

-2016 -2016 Declined. VeRes status isunknown

- , 3dsecure. / Issuing bank could notdetermine if the card is 3dsecure.

-2015 -2015 Decline by iReq in VERes VERes DS iReq, . / VERes from DScontains iReq, which caused the payment rejection.

-2013 -2013

. / All payment attempts were used.

-2012 -2012 Operation not supported . / This operation is not supported.

-2011 -2011 Declined. PaRes status isunknown

- 3dsecure- / Issuing bank was not able toperform 3dsecure card authorization.

-2010 -2010 XID XID. / Mismatching of XID.

-2008 -2008 . / Wrong purse.

-2007 2007 Decline. Payment timelimit

, ( - 20 ; ; "

). / ", ,

The period allotted for card details entering has expired (by default timeout is 20 minutes;session duration may be specified while order registering; if the merchant has "Alternativesession timeout" permission, then timeout duration is specified in merchant settings).

-2006 2006 Decline. 3DSec decline , (3DS ) / Meansthat issuing bank rejected authentication (3DS authorization has not been performed).

-2005 2005 Decline. 3DSec sign error , , PARes , . / Means that RBS could not check issuing bank sign, i.e. PARes wasreadable, but the sign was wrong.

-2003 -2003 . / Blocking by port.

-2002 2002 Decline. Payment overlimit

, . : - , , . / Transaction was rejected because payment amount exceeded established limits. Note: it couldbe limit of day withdrawal established by Bank-acquirer, or limit of transaction by one cardestablished by a merchant, or limit for one transaction established by a merchant.

-2001 2001 Decline. IP blacklisted , IP- . /Transaction is rejected since Client's IP-address is in the black list.

-2000 2000 Decline. PAN blacklisted , . / Transactionis rejected since card number in in the black list.

-102 -102

. / The payment was cancelled by the payment agent.

-100 -100 no_payments_yet . / There were not payment attempts.

-1 -1 sv_unavailable . / The timer of waiting ofprocessing response has expired.

0 0 Approved. . / Payment has been performed successfully.

1 1 Declined. Honor with id . - (- ) , declined. /Proof of identity is necessary for successful completion of the transaction. In case of internettransaction (our case) it is impossible, so transaction is considered as declined.

5 5 Decline. Unable toprocess

. / Refuse of network to process transaction.

100 100 Decline. Card declined ( e). / Card limits(Issuing bank forbade internet transactions by the card).

101 101 Decline. Expired card . / Card is expired.

103 103 Decline. Call issuer -. -. / There is no connection with the Issuing bank. Sales oulet need to contactIssuing bank.

104 104 Decline. Card declined , . / This is an attempt to perform a transaction by an account that has restrictionsfor use.

106 106 . .

. . / The maximum number of attempts to enter PIN is exceeded. It is possiblethat the card is blocked temporary.

107 107 Decline. Call issuer -. / Please, contact Issuing bank.

109 109 Decline. Invalidnjmerchant

/ . / Merchant/terminal identifier is incorrect or ACC is blocked on the processing level.

110 110 Decline. Invalid amount . / Transaction amount is incorrect.

111 111 Decline. No card record . / Card number is incorrect.

116 116 Decline. Not enoughmoney

. /Transaction amount exceeds the available balance of the selected account.

119 119 Decline.SECURITY_VIOLATION SV

. / Illegal transaction.

120 120 Decline. Not allowed - . - 57. . / Refusal to perform the operation - the transaction is not allowed by Issuing bank. Responsecode of the IPS - 57. Reasons for rejection should be specified an the issuing bank.

121 121 Decline. Excds wdrwllimt

, , -. / This is an attempt to perform transaction of amount exceedingthe day limit established by the issuing bank.

123 123 Decline. Excds wdrwlltmt

: . / The client hasperformed the maximum number of transactions during the limit cycle and tries to performanother one.

125 125 Decline. Card declined . : , , . AmEx - . / Card number is incorrect. This error may have several meanings: Attempt to perform a refundof amount exceeding the hold amount; Attempt to refund zero amount; for AmEx - expiry dateis specified incorrectly.

208 208 Decline. Card is lost . / Card is lost.

209 209 Decline. Card limitationsexceeded

. / Card limitations exceeded.

400 400 . . / Reversal is processed.

902 902 Decline. Invalid trans ( , ). / Card limitations (Cardholder tries to perform a transaction that isforbidden for him).

903 903 Decline. Re-enter trans. , , -. / Attempt to perform a transaction of amount exceeding Issuing bank limit.

904 904 Decline. Format error . / The message format isincorrect in terms of the issuing bank.

907 907 Decline. Host not avail. , . stand-in ( , , ). / There is no connection with the Issuing bank. Authorization in stand-in mode is not allowed forthis card number (this mode means that the Issuing bank is unable to connect to the IPS, andtherefore the transaction can be either offline with further unloading to back office, or it can bedeclined).

909 909 Decline. Call issuer ( , . -). / Operation is impossible(General error of the system functioning. May be detected by IPS or the Issuing bank).

910 910 Decline. Host not avail. - . / Issuing bank is not available.

913 913 Decline. Invalid trans ( ). /The message format is incorrect in terms of IPS.

914 914 Decline. Orig trans notfound

( reversal refund). /Transaction is not found (when sending a completion, reversal or refund request).

999 999 Declined by fraud . 3dsec. /The beginning of the transaction authorization is missed. Declined by fraud.

1001 1001 Decline. Data inputtimeout

( , .. ). / Empty (is specified at the moment of transaction authorization,when card details are not entered yet).

1004 1004 1 1. / Authorization phase 1.

1005 1005 2 2. / Authorization phase 2.

2001 2001 Decline. Fraud ( ). / Fraud (in terms ofIPS).

2002 2002 . / Incorrect operation.

2003 2003 Decline. SSL restricted SSL ( 3d-Secure/SecureCode) . / SSL (not3D-Secure/SecureCode) transactions are forbidden for the Merchant.

2004 2004 SSL without CVCforbidden

SSL CV2 . / Payment through SSL without CVC2 isforbidden.

2005 2005 3DS rule failed 3ds. / Payment does not meet termsof the rule of 3ds validation.

2006 2006

. / One-phase payments are forbidden.

2007 2007 . / The order is payed.

2008 2008

. / The transaction is not completed.

2009 2009

. / Refund amount exceeds deposited amount.

9001 9001 RBS internal error . / RBS internal error.

71015 1015 Decline. Input error . / Entered card details are incorrect.

151017 1017 Decline. 3DSec commerror

3-D Secure - . / 3-D Secure - communication error.

151018 018 Decline. Processingtimeout

. . / Processing timeout. Sending is failed.

151019 1019 Decline. Processingtimeout

. , . / Processingtimeout. Sending is success, response from the bank was not received.

341014 1014 Decline. General Error . / RBS general error.

Documents

MerchantManual Alfa 20140414 Ru