Замовлення на обмін валюти

Зробити заявку на купівлю/продаж валюти

POST : https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/{type}

Параметр {type} може приймати наступні значення

sale-to-client - продати валюту клієнту (клієнт хоче купити)
buy-from-client - купити валюту від клієнта (клієнт хоче здати)
cross-ex - операція обміну однієї валюти на іншу (крос обмін)

Для типів sale-to-client (продаж клієнту) та buy-from-client(купівля від клієнта) тіло запиту має наступний формат

Request BODY

{
    "currFromCode":"USD",
    "sum":200,
    "rate":39.8,
    "department":"8309EEE8-FE05-4E9C-8998-EA6242E2FE8E",
    "transactionId":"T001",
    "comment":"",
    "callbackReq":"https://affiliate-site.com/callback-handler"
}

cURL

curl --location --globoff 'https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/sale-to-client' \
--header 'access-token: 00000000-0000-0000-0000-000000000000' \
--header 'Content-Type: application/json' \
--data '{
    "currFromCode":"USD",
    "sum":200,
    "rate":39.8,
    "department":"8309EEE8-FE05-4E9C-8998-EA6242E2FE8E",
    "transactionId":"T001",
    "comment":"",
    "callbackReq":"https://affiliate-site.com/callback-handler",
}'

Для типу cross-ex (крос обмін) тіло запиту має наступний формат

Request BODY

{
    "currFromCode":"USD",
    "currencyToCode":"EUR",
    "sum":200,
    "rate":0.92,
    "department":"8309EEE8-FE05-4E9C-8998-EA6242E2FE8E",
    "transactionId":"T002",
    "comment":"",
    "callbackReq":"https://affiliate-site.com/callback-handler",
}

cURL

curl --location --globoff 'https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/cross-ex' \
--header 'access-token: 00000000-0000-0000-0000-000000000000' \
--header 'Content-Type: application/json' \
--data '{
    "currFromCode":"USD",
    "currencyToCode":"EUR",
    "sum":200,
    "rate":0.92,
    "department":"8309EEE8-FE05-4E9C-8998-EA6242E2FE8E",
    "transactionId":"T002",
    "comment":"",
    "callbackReq":"https://affiliate-site.com/callback-handler",
}'

Success response

{
        "statusCode":200,
        "statusMessage":"success",
        "data":{
                "sum":200,
                "currFromCode":"USD",
                "currencyToCode":"UAH",
                "type":"buy-from-client",
                "rate":38.9,
                "department":
                        {
                                "hash":"8309EEE8-FE05-4E9C-8998-EA6242E2FE8E",
                                "name":"Відділення №1"
                        },
                "comment":"",
                "orderHash":"86C05C79-4E39-4BA8-AED8-C24F624575DC",
                "orderNum":"A001@T001",
                "createDate":"01.02.2023T16:44:06",
                "waitTimeInMinutes":720,
                "status":
                        {
                                "date":"01.02.2023T16:44:07",
                                "id":1,
                                "name":"Створено"
                        }
                }
}

Відправка повідомлення при зміні статусу замовлення

Якщо при створенні замовлення, було передано значення callbackReq , при будь-якій зміні статусу цього замовлення, на вказану у значенні callbackReq адресу буде надіслано дані через POST запит

Request BODY

{
    "transactionId":"T001",
    "orderHash":"86C05C79-4E39-4BA8-AED8-C24F624575DC",
    "status":
        {
                "date":"01.02.2023T17:01:21",
                "id":2,
                "name":"Прийнято менеджером"
        }
}

Переглянути статус заявки

GET : https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/{orderHash}

cURL

curl --location --globoff 'https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/86C05C79-4E39-4BA8-AED8-C24F624575DC' \
--header 'access-token: 00000000-0000-0000-0000-000000000000' \
--data ''

Success response

{
        "statusCode":200,
        "statusMessage":"success",
        "data":{
                "sum":200,
                "currFromCode":"USD",
                "currencyToCode":"UAH",
                "type":"buy-from-client",
                "rate":38.9,
                "department":
                        {
                                "hash":"8309EEE8-FE05-4E9C-8998-EA6242E2FE8E",
                                "name":"Відділення №1"
                        },
                "comment":"",
                "orderHash":"86C05C79-4E39-4BA8-AED8-C24F624575DC",
                "orderNum":"A001@T001",
                "createDate":"01.02.2023T16:44:06",
                "waitTimeInMinutes":720,
                "status":
                        {
                                "date":"01.02.2023T16:44:07",
                                "id":1,
                                "name":"Створено"
                        }
                }
}

Переглянути статус заявки

DELETE : https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/{orderHash}

cURL

curl --location --globoff --request DELETE 'https://{endpoint}/affiliates/{userHash}/{accessToken}/orders/86C05C79-4E39-4BA8-AED8-C24F624575DC' \
--header 'access-token: 00000000-0000-0000-0000-000000000000' \
--data ''

Success response

{
        "statusCode":200,
        "statusMessage":"success",
        "data": true
}