Page History
...
If for any reason it is more convenient for the merchant to independently display an offer to the customer to pay the order with a previously saved card (on its website or in a specialized mobile application), then in order to use CIT COF, the merchant has to call the Token Pay payment web-service.
The request URL for transfer the encrypted payment data block:
https://<SERVER_NAME>/pay/tokenpay.cfm ,
As <SERVER_NAME> you should use the received from support service (support@assist.ru) value as the domain name.
List of request parameters:
...
Parameter
...
Mandatory field
...
Adopted values
...
Default value
...
Description
...
Merchant_ID
...
Yes
...
Number
...
The enterprise identifier in IPS Assist
...
Login
...
Yes
...
8-20 characters
...
Login in IPS Assist (Latin letters, digits and symbol _)
...
Password
...
Yes
...
8-20 characters
...
Password in IPS Assist (Latin letters and digits)
...
OrderNumber
...
Yes
...
128 characters
...
Order number in the merchant payments system
...
OrderAmount
...
Yes
...
Number, 15 digits (delimiter: '.')
...
Payment amount, in original currency (e.g., 10.34).
...
OrderCurrency
...
No
...
3 characters
...
Currency of legal entity/enterprise
...
Code of currency of the OrderAmount
...
OrderComment
...
No
...
256 characters
...
Comment.
...
Delay
...
No
...
0 – one-stage operation
1 – double-stage operation
...
0
...
Attribute of a bankcard authorization for the double-stage operation mode.
...
Language
...
No
...
RU – Russian,
EN – English
...
Language of legal entity/enterprise
...
Language of authorized pages
...
ClientIP
...
No
...
Maximum of 15 digits, 4 delimiters «.»
...
IP-address of the customer
...
TokenType
...
No
...
5 – Assist;
...
1
...
Payment Token Type Identifier
...
PaymentToken
...
No
...
JSON
...
Payment Token
{"Token":"<UUID>", "CustomerNumber":"<CustomerNumber>"}
...
Lastname
...
No
...
70 characters
...
Customer's last name.
...
Firstname
...
No
...
70 characters
...
Customer's first name.
...
Middlename
...
No
...
70 characters
...
Customer's middle name.
...
...
No
...
128 characters
...
Customer's e-mail.
...
Address
...
No
...
256 characters
...
Customer's address.
...
HomePhone
...
No
...
64 characters
...
Customer's home phone number.
...
WorkPhone
...
No
...
20 characters
...
Customer's work phone number.
...
MobilePhone
...
No
...
20 characters
...
Customer's mobile phone number.
...
Fax
...
No
...
20 characters
...
Customer's fax number.
...
Country
...
No
...
3 characters
...
Customer's country.
...
State
...
No
...
3 characters
...
Customer's region.
...
City
...
No
...
70 characters
...
Customer's city.
...
Zip
...
No
...
25 characters
...
Customer's post zip code.
...
isConvert
...
No
...
0 – don't convert to the base currency
1 - don't convert to the base currency if possible
2 – always convert to the base currency
...
1
...
Currency conversion indicator
...
Format
...
No
...
4 – SOAP
5 – JSON
...
5
...
Results format.
...
Signature
...
No
...
String
...
The string is joined according to determined rules.
Then the MD5 hash prepared from this string. Hash is signed by private RSA key of the merchant. Key length - 1024. Received bit sequence is a signature. Signature is transferred BASE64 coded string.
...
Chequeitems
...
No/Yes**
...
String in JSON-format
...
Cheque items according to the section “Payment with cheque”.
...
GenerateReceipt
...
No
...
0 or 1
...
1
...
Permission to generate of a fiscal receipt. If the value of parameter is 0, the generation of a fiscal receipt is prohibited for this order.
...
Tax
...
No
...
10 characters
...
Parameter is determined by the “Default tax rate” option of the merchant and used in the mode without transfer of the cheque items (the entire amount must be paid with one rate).
...
...
ReceiptLine
...
No
...
128 characters
...
Parameter is determined by the “Default text of cheque item” option of the merchant and used in the mode without transfer of the cheque items.
...
Text description of the cheque item, if the cheque has one single item.
...
FPMode
...
No
...
Number
...
Parameter is determined by the “Default payment method” option of the merchant and used in the mode without transfer of the cheque items.
...
...
TaxationSystem
...
No/Yes*
...
Number
...
From the merchant’s or CRE settings
...
Note to the parameter TokenType, the value of which should be equal to 5, and also the value of the PaymentToken parameter, which must contain the unique customer number in the merchant database (CustomerNumber) and the unique identifier of the saved customer card received during the initial operation of this customer from the IPS Assist.
...
The list of response parameters is similar to the standard response of the Token Pay service.
| Note |
|---|
Payment will be made as a CIT COF operation only if the corresponding processing is set up for the merchant in the IPS Assist. Otherwise, the operation will fail. |
...
{"fault":{"detail":"<error message>","faultcode":<first tcode>,"faultstring":<second code >}}.
Example of the response when the customer has several cards:
...
{"fault":{"detail":"<error message>","faultcode":<first tcode>,"faultstring":<second code >}}.