API
Payment
A preliminary check of parameters
xml json |
The URL for sending a request: | defined by the seller in additional parameter settings (if the url contains "format=json" then the data is transferred in json format) | ||||||||||||||||||
Method: | POST | ||||||||||||||||||
Request format: |
|
||||||||||||||||||
Response parameters: |
|
||||||||||||||||||
Response format: |
|
||||||||||||||||||
Response parameters: |
|
Determining the values of the parameters of the goods upon purchase
xml json |
The URL for sending a request: | https://api.digiseller.ru/api/purchases/options | ||||||||||||||||||||||||||||||
Method: | POST | ||||||||||||||||||||||||||||||
Request headers: |
Accept: "application/json" Content-Type: "application/json" Accept: "application/xml" Content-Type: "application/xml" |
||||||||||||||||||||||||||||||
Request format: |
|
||||||||||||||||||||||||||||||
Request parameters: |
|
||||||||||||||||||||||||||||||
Response format: |
|
||||||||||||||||||||||||||||||
Response parameters: |
|
Work with the shopping cart
1. Adding of products to the cart
The URL for sending a request: | //shop.digiseller.ru/xml/shop_cart_add.asp | |||||||||||||||||||||||||||||||||||||||
Method: |
POST Content-Type: application/x-www-form-urlencoded |
|||||||||||||||||||||||||||||||||||||||
Request format: | product_id=1239468&product_cnt=2&typecurr=wmr&email=buyer_@email@mail.com&lang=ru-RU&cart_uid=6420808B4ACC46BEBB04749EC63FF062&id_po=22418804 | |||||||||||||||||||||||||||||||||||||||
Request parameters: |
|
|||||||||||||||||||||||||||||||||||||||
JSON response format: | ||||||||||||||||||||||||||||||||||||||||
Response parameters: |
|
2. Getting a list of in-cart products + updating product quantities in the cart
URL and request format: | //shop.digiseller.ru/xml/shop_cart_lst.asp | ||||||||||||||||||
Method: |
POST Content-Type: application/x-www-form-urlencoded |
||||||||||||||||||
Request parameters: |
|
||||||||||||||||||
JSON response format:
response sample |
|||||||||||||||||||
Response parameters: |
|
Jump to payment
An example of sending the user through FORM POST: |
|
||||||||||||||||||||||||||||||
Request parameters: |
|
Настройка индивидуальных способов оплаты
1. Инициализация платежа
The URL for sending a request: | берется из настроек из поля "URL оплаты" | |||||||||||||||||||||||||||
Method: |
POST Content-Type: application/x-www-form-urlencoded |
|||||||||||||||||||||||||||
Request format: | invoice_id=12345&amount=10.00¤cy=USD&description=товар&lang=ru-RU&payment_id=8&return_url=https://www.digiseller.market/info/buy.asp?id_i=12345&uid=FB4902995B8EDC36D9DC66F743E9E9CF9607284928E3CD484A0AA | |||||||||||||||||||||||||||
Request parameters: |
|
2. Обновление статуса платежа
URL and request format: | https://digiseller.market/callback/api | |||||||||||||||||||||
Method: |
GET Content-Type: application/x-www-form-urlencoded |
|||||||||||||||||||||
Request format: | invoice_id=12345&amount=10.00¤cy=USD&status=paid&signature=FB4902995B8EDC36D9DC66F743E9E9CF9607284928E3CD484A0AA | |||||||||||||||||||||
Request parameters: |
|
3. Получение статуса платежа
URL and request format: | берется из настроек из поля "URL статуса платежа" | ||||||||||||||||||||||||
Method: |
GET Content-Type: application/x-www-form-urlencoded |
||||||||||||||||||||||||
Request format: | invoice_id=12345&amount=10.00¤cy=USD&seller_id=8531&signature=FB4902995B8EDC36D9DC66F743E9E9CF9607284928E3CD484A0AA | ||||||||||||||||||||||||
Request parameters: |
|
||||||||||||||||||||||||
JSON response format: |
|
||||||||||||||||||||||||
Response parameters: |
|
4. Подпись
Для формирования криптографической подписи данных запроса/ответа необходимо сформировать из данных запроса/ответа строку следующим образом: для каждой пары (ключ, значение), в алфавитном порядке следования ключей, сначала записывается ключ, потом символ :(двоеточие), потом значение. Каждая пара ключ:значение завершается символом ;(точкой с запятой).
Параметры: |
1. Хеш-функция — sha256 2. Секретный ключ — берется из настроек |
Формирование подписи: |
1. Сформировать строку из данных запроса 2. Сгенерировать HMAC для этой строки, согласно общепринятому алгоритму формирования HMAC RFC 2104 в языке PHP, например, реализуется функцией hash_hmac используя свой секретный ключ и указанную в наборе параметров хэш - функцию. Выходная строка должна быть в формате HEX. |
Пример: |
Данные запроса: invoice_id=12345&amount=10.00¤cy=USD&seller_id=8531 Полученная строка: amount:10.00;currency:USD;invoice_id:12345;seller_id:8531; Данные ответа: {"invoice_id":"12345", "amount":"10.00", "currency":"USD", "status":"paid"} Полученная строка: amount:10.00;currency:USD;invoice_id:12345;status:paid; |