MENU navbar-image

Introduction

MagicPayments API

Данная документация предоставляет полное описание методов API для работы с сервисом.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {ACCESS_TOKEN}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking Generate API token.

Операции

Пополнение

requires authentication

Запрос на пополнение кошелька

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/351d5c66-ec5b-3135-9b5a-33387e2ad232/invoice" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 1000,
    \"calculate\": true,
    \"tokenize_card\": false,
    \"tag\": \"trusted\",
    \"callback_method\": \"POST\",
    \"callback_url\": \"http:\\/\\/www.tremblay.info\\/illo-qui-eveniet-quia-suscipit\",
    \"success_url\": \"http:\\/\\/www.bailey.info\\/numquam-rerum-et-id.html\",
    \"fail_url\": \"http:\\/\\/muller.info\\/nesciunt-aliquid-molestiae-enim.html\",
    \"card_token\": \"accusamus\",
    \"card\": {
        \"pan\": \"4111111111111111\",
        \"cardholder\": \"IVAN IVANOV\",
        \"month\": \"01\",
        \"year\": \"28\",
        \"cvv\": \"123\"
    },
    \"addition_data\": {
        \"email\": \"[email protected]\",
        \"payment_system_id\": \"Sberbank\"
    }
}"
const url = new URL(
    "https://api.magic-payments.com/api/351d5c66-ec5b-3135-9b5a-33387e2ad232/invoice"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "amount": 1000,
    "calculate": true,
    "tokenize_card": false,
    "tag": "trusted",
    "callback_method": "POST",
    "callback_url": "http:\/\/www.tremblay.info\/illo-qui-eveniet-quia-suscipit",
    "success_url": "http:\/\/www.bailey.info\/numquam-rerum-et-id.html",
    "fail_url": "http:\/\/muller.info\/nesciunt-aliquid-molestiae-enim.html",
    "card_token": "accusamus",
    "card": {
        "pan": "4111111111111111",
        "cardholder": "IVAN IVANOV",
        "month": "01",
        "year": "28",
        "cvv": "123"
    },
    "addition_data": {
        "email": "[email protected]",
        "payment_system_id": "Sberbank"
    }
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/351d5c66-ec5b-3135-9b5a-33387e2ad232/invoice';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'amount' => 1000.0,
            'calculate' => true,
            'tokenize_card' => false,
            'tag' => 'trusted',
            'callback_method' => 'POST',
            'callback_url' => 'http://www.tremblay.info/illo-qui-eveniet-quia-suscipit',
            'success_url' => 'http://www.bailey.info/numquam-rerum-et-id.html',
            'fail_url' => 'http://muller.info/nesciunt-aliquid-molestiae-enim.html',
            'card_token' => 'accusamus',
            'card' => [
                'pan' => '4111111111111111',
                'cardholder' => 'IVAN IVANOV',
                'month' => '01',
                'year' => '28',
                'cvv' => '123',
            ],
            'addition_data' => [
                'email' => '[email protected]',
                'payment_system_id' => 'Sberbank',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/351d5c66-ec5b-3135-9b5a-33387e2ad232/invoice'
payload = {
    "amount": 1000,
    "calculate": true,
    "tokenize_card": false,
    "tag": "trusted",
    "callback_method": "POST",
    "callback_url": "http:\/\/www.tremblay.info\/illo-qui-eveniet-quia-suscipit",
    "success_url": "http:\/\/www.bailey.info\/numquam-rerum-et-id.html",
    "fail_url": "http:\/\/muller.info\/nesciunt-aliquid-molestiae-enim.html",
    "card_token": "accusamus",
    "card": {
        "pan": "4111111111111111",
        "cardholder": "IVAN IVANOV",
        "month": "01",
        "year": "28",
        "cvv": "123"
    },
    "addition_data": {
        "email": "[email protected]",
        "payment_system_id": "Sberbank"
    }
}
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "status": "success",
    "comission": 1,
    "total": 99,
    "amount": 100,
    "url": "https://example.com/redirect",
    "transaction": {
        "currency": "RUB",
        "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
        "order": "73450234",
        "status_transaction": "created",
        "total": 99
    }
}
 

Example response (400):


{
    "status": "error",
    "error": "Данный канал не поддерживает рекуррентные платежи",
    "code": "recurrent_not_supported"
}
 

Example response (422):


{
    "status": "error",
    "error": {
        "amount": [
            "Поле amount должно быть числом."
        ]
    }
}
 

Request      

POST api/{wallet_uuid}/invoice

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 351d5c66-ec5b-3135-9b5a-33387e2ad232

Body Parameters

amount   number   

Сумма к пополнению Example: 1000

order   string  optional  

Внешний идентификатор (макс 100 символов)

calculate   boolean  optional  

Рассчитать комиссию Example: true

tokenize_card   boolean  optional  

Получить токен карты (для рекуррентных платежей) Example: false

tag   string  optional  

Тэг терминала. Example: trusted

callback_method   string  optional  

Определяет метод вызова callback. Возможные значения: POST, GET Example: POST

callback_url   string  optional  

Callback url вызывается GET/POST (определяется в поле callback_method) запросом, когда статус транзакции меняет статус. В параметрах GET запроса передаются: transaction - идентификатор транзакции, order - внешний идентификатор транзакции. В теле POST запроса передается текущая транзакция в виде JSON. Example: http://www.tremblay.info/illo-qui-eveniet-quia-suscipit

success_url   string  optional  

Вызывается в случае успешной оплаты. В параметрах GET запроса передаются: transaction - идентификатор транзакции, order - внешний идентификатор транзакции. Example: http://www.bailey.info/numquam-rerum-et-id.html

fail_url   string  optional  

Вызывается в случае ошибки в оплате. В параметрах GET запроса передаются: transaction - идентификатор транзакции, order - внешний идентификатор транзакции. Example: http://muller.info/nesciunt-aliquid-molestiae-enim.html

card_token   string  optional  

Токен карты (для рекуррентных платежей) Example: accusamus

card   object  optional  

Данные карты (для оплаты host2host)

pan   string  optional  

Номер карты (для оплаты host2host) Example: 4111111111111111

cardholder   string  optional  

Держатель карты (для оплаты host2host) Example: IVAN IVANOV

month   string  optional  

Месяц срока действия карты (2 цифры) (для оплаты host2host) Example: 01

year   string  optional  

Год срока действия карты (2 цифры) (для оплаты host2host) Example: 28

cvv   string  optional  

CVV карты (3 цифры) (для оплаты host2host) Example: 123

addition_data   object  optional  

Дополнительные данные для оплаты (не обязательно)

email   string  optional  

Email клиента Example: [email protected]

phone   string  optional  

Телефон клиента

address   string  optional  

Адрес клиента

city   string  optional  

Город клиента

state   string  optional  

Штат/область клиента

country   string  optional  

Страна клиента

zip_code   string  optional  

Почтовый индекс клиента

customer_ip   string  optional  

IP адрес клиента

customer_id   string  optional  

ID клиента

customer_first_name   string  optional  

Имя клиента

customer_last_name   string  optional  

Фамилия клиента

customer_doc_number   string  optional  

Номер документа удостоверяющего личность

customer_date_birth   string  optional  

Дата рождения в формате ДД-ММ-ГГГГ

device_browser_accept_header   string  optional  

Принимаемый контент (для 3DS 2.0)

device_browser_java_enabled   string  optional  

Признак работы с Java (для 3DS 2.0)

device_browser_language   string  optional  

Язык браузера (для 3DS 2.0)

device_browser_color_depth   string  optional  

Глубина цвета браузера (для 3DS 2.0)

device_browser_screen_height   string  optional  

Высота экрана (для 3DS 2.0)

device_browser_screen_width   string  optional  

Ширина экрана (для 3DS 2.0)

device_browser_window_height   string  optional  

Высота окна браузера (для 3DS 2.0)

device_browser_window_width   string  optional  

Ширина окна браузера (для 3DS 2.0)

device_browser_tz   string  optional  

Часовой пояс браузера в минутах от UTC (для 3DS 2.0)

device_browser_user_agent   string  optional  

Пользовательский агент браузера (для 3DS 2.0)

challenge_window_size   string  optional  

Размер окна для challenge (для 3DS 2.0)

payment_system_id   string  optional  

ID платежной системы Example: Sberbank

Response

Response Fields

status   string   

Статус запроса

comission   number   

Комиссия

total   number   

Сумма к зачислению

amount   number   

Сумма к оплате

url   string   

URL для перенаправления на страницу оплаты

addition_data   object   

Дополнительная информация при расчете транзакции (отсутствует если calculate=false)

payment_systems   string[]   

Список платежных систем (отсутствует если calculate=false или если в настройках выключены платежные системы)

last_error   string   

Описание ошибки при проведении транзакции (может быть null) (отсутствует если calculate=true)

transaction   object   

Блок описания транзакции (отсутствует если calculate=true)

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

type_alias   string   

Тип транзакции (payin - пополнение, payout - выплата, refund - Refund, chargeback - Chargeback)

card_mask   string   

Маска карты (может быть null)

payment_details   object   

Реквизиты для оплаты (может быть null)

Выплата

requires authentication

Запрос выплаты на карту с кошелька

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/a5df511d-c0fd-35c1-93a3-0c92a77ab620/withdrawal" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 933.6,
    \"card\": \"4111111111111111\",
    \"payout_address\": {
        \"type\": \"usdt_trc20\",
        \"address\": \"TCgBa3WVrrcQoBfd6bZdiFLatZ....\"
    },
    \"calculate\": true,
    \"tag\": \"trusted\",
    \"callback_url\": \"http:\\/\\/wintheiser.com\\/repellat-dolores-ut-incidunt-omnis.html\",
    \"callback_method\": \"POST\",
    \"addition_data\": {
        \"email\": \"[email protected]\",
        \"cardholder\": \"IVAN IVANOV\",
        \"payment_system_id\": \"Sberbank\"
    }
}"
const url = new URL(
    "https://api.magic-payments.com/api/a5df511d-c0fd-35c1-93a3-0c92a77ab620/withdrawal"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "amount": 933.6,
    "card": "4111111111111111",
    "payout_address": {
        "type": "usdt_trc20",
        "address": "TCgBa3WVrrcQoBfd6bZdiFLatZ...."
    },
    "calculate": true,
    "tag": "trusted",
    "callback_url": "http:\/\/wintheiser.com\/repellat-dolores-ut-incidunt-omnis.html",
    "callback_method": "POST",
    "addition_data": {
        "email": "[email protected]",
        "cardholder": "IVAN IVANOV",
        "payment_system_id": "Sberbank"
    }
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/a5df511d-c0fd-35c1-93a3-0c92a77ab620/withdrawal';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'amount' => 933.6,
            'card' => '4111111111111111',
            'payout_address' => [
                'type' => 'usdt_trc20',
                'address' => 'TCgBa3WVrrcQoBfd6bZdiFLatZ....',
            ],
            'calculate' => true,
            'tag' => 'trusted',
            'callback_url' => 'http://wintheiser.com/repellat-dolores-ut-incidunt-omnis.html',
            'callback_method' => 'POST',
            'addition_data' => [
                'email' => '[email protected]',
                'cardholder' => 'IVAN IVANOV',
                'payment_system_id' => 'Sberbank',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/a5df511d-c0fd-35c1-93a3-0c92a77ab620/withdrawal'
payload = {
    "amount": 933.6,
    "card": "4111111111111111",
    "payout_address": {
        "type": "usdt_trc20",
        "address": "TCgBa3WVrrcQoBfd6bZdiFLatZ...."
    },
    "calculate": true,
    "tag": "trusted",
    "callback_url": "http:\/\/wintheiser.com\/repellat-dolores-ut-incidunt-omnis.html",
    "callback_method": "POST",
    "addition_data": {
        "email": "[email protected]",
        "cardholder": "IVAN IVANOV",
        "payment_system_id": "Sberbank"
    }
}
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "status": "success",
    "comission": 1,
    "total": 99,
    "amount": 100,
    "transaction": {
        "currency": "RUB",
        "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
        "order": "73450234",
        "status_transaction": "created",
        "total": 99
    }
}
 

Example response (400):


{
    "status": "error",
    "error": "Ошибка доступа",
    "code": "access_denied"
}
 

Example response (422):


{
    "status": "error",
    "error": {
        "amount": [
            "Поле amount должно быть числом."
        ]
    }
}
 

Request      

POST api/{wallet_uuid}/withdrawal

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: a5df511d-c0fd-35c1-93a3-0c92a77ab620

Body Parameters

amount   number   

Сумма к выплате Example: 933.6

order   string  optional  

Внешний идентификатор (макс 100 символов)

card   string   

Карта для выплаты (16-19 цифр) Example: 4111111111111111

payout_address   object  optional  

Адрес для перевода

type   string  optional  

Тип адреса для перевода. Возможные значения: usdt_trc20. Example: usdt_trc20

address   string  optional  

Адрес для перевода Example: TCgBa3WVrrcQoBfd6bZdiFLatZ....

calculate   boolean  optional  

Рассчитать комиссию Example: true

tag   string  optional  

Тэг терминала. Example: trusted

callback_url   string  optional  

Callback url вызывается GET запросом, когда статус транзакции меняется на completed. В параметрах GET запроса передаются: transaction - идентификатор транзакции, order - внешний идентификатор транзакции Example: http://wintheiser.com/repellat-dolores-ut-incidunt-omnis.html

callback_method   string  optional  

Определяет метод вызова callback. Возможные значения: POST, GET Example: POST

addition_data   object  optional  

Дополнительные данные для оплаты (не обязательно)

email   string  optional  

Email клиента Example: [email protected]

phone   string  optional  

Телефон клиента

address   string  optional  

Адрес клиента

city   string  optional  

Город клиента

state   string  optional  

Штат/область клиента

country   string  optional  

Страна клиента

zip_code   string  optional  

Почтовый индекс клиента

customer_ip   string  optional  

IP адрес клиента

customer_id   string  optional  

ID клиента

customer_first_name   string  optional  

Имя клиента

customer_last_name   string  optional  

Фамилия клиента

customer_doc_number   string  optional  

Номер документа удостоверяющего личность

customer_date_birth   string  optional  

Дата рождения в формате ДД-ММ-ГГГГ

card_expiration_year   string  optional  

Год строка действия карты

card_expiration_month   string  optional  

Месяц строка действия карты

cardholder   string  optional  

Держатель карты Example: IVAN IVANOV

payment_system_id   string  optional  

ID платежной системы Example: Sberbank

Response

Response Fields

status   string   

Статус запроса

comission   number   

Комиссия

total   number   

Сумма к зачислению

amount   number   

Сумма к оплате

addition_data   object   

Дополнительная информация при расчете транзакции (отсутствует если calculate=false)

payment_systems   string[]   

Список платежных систем (отсутствует если calculate=false или если в настройках выключены платежные системы)

last_error   string   

Описание ошибки при проведении транзакции (может быть null) (отсутствует если calculate=true)

transaction   object   

Блок описания транзакции (отсутствует если calculate=true)

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

type_alias   string   

Тип транзакции (payin - пополнение, payout - выплата, refund - Refund, chargeback - Chargeback)

card_mask   string   

Маска карты (может быть null)

payment_details   object   

Реквизиты для оплаты (может быть null)

Статус операции

requires authentication

Запрос статуса по операции (выплата/пополнение) (транзакцию можно получить по ее uuid или по внешнему идентификатору order)

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/b6d6094d-35e7-3f14-b1d0-402bc46aa67e/status" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
const url = new URL(
    "https://api.magic-payments.com/api/b6d6094d-35e7-3f14-b1d0-402bc46aa67e/status"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/b6d6094d-35e7-3f14-b1d0-402bc46aa67e/status';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/b6d6094d-35e7-3f14-b1d0-402bc46aa67e/status'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers)
response.json()

Example response (200):


{
    "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
    "order": "73450234",
    "currency": "RUB",
    "status_transaction": "created",
    "created_at": "2022-03-04T08:17:54.000000Z",
    "total": "99.00"
}
 

Request      

POST api/{wallet_uuid}/status

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: b6d6094d-35e7-3f14-b1d0-402bc46aa67e

Body Parameters

transaction   string  optional  

UUID транзакции

order   string  optional  

Внешний идентификатор (макс 100 символов)

Response

Response Fields

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

currency   string   

Валюта

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

created_at   string   

Дата создания в UTC

total   number   

Сумма зачисления

amount   number   

Сумма заказа

last_error   string   

Описание последней ошибки (может быть null)

card_mask   string   

Маска карты (может быть null)

card_token   string   

Токен карты для формирования рекуррентных платежей (может отсутствовать)

payment_details   object   

Реквизиты для оплаты (может быть null)

Refund

requires authentication

Оформить refund по операции. В ответ возвращается refund транзакция.

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/563e3539-f8eb-323c-b6da-40f842f6180e/refund" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
const url = new URL(
    "https://api.magic-payments.com/api/563e3539-f8eb-323c-b6da-40f842f6180e/refund"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/563e3539-f8eb-323c-b6da-40f842f6180e/refund';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/563e3539-f8eb-323c-b6da-40f842f6180e/refund'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers)
response.json()

Example response (200):


{
    "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
    "order": "73450234",
    "currency": "RUB",
    "status_transaction": "created",
    "created_at": "2022-03-04T08:17:54.000000Z",
    "total": "99.00"
}
 

Request      

POST api/{wallet_uuid}/refund

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 563e3539-f8eb-323c-b6da-40f842f6180e

Body Parameters

transaction   string  optional  

UUID транзакции

order   string  optional  

Внешний идентификатор (макс 100 символов)

Response

Response Fields

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

currency   string   

Валюта

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

created_at   string   

Дата создания в UTC

total   number   

Сумма зачисления

amount   number   

Сумма заказа

type_alias   string   

Тип транзакции (payin - пополнение, payout - выплата, refund - Refund, chargeback - Chargeback)

Chargeback

requires authentication

Оформить chargeback по операции. В ответ возвращается chargeback транзакция.

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/93fc2f67-1fd2-3f9f-9626-c17af5824303/chargeback" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"arn\": null
}"
const url = new URL(
    "https://api.magic-payments.com/api/93fc2f67-1fd2-3f9f-9626-c17af5824303/chargeback"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "arn": null
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/93fc2f67-1fd2-3f9f-9626-c17af5824303/chargeback';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'arn' => null,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/93fc2f67-1fd2-3f9f-9626-c17af5824303/chargeback'
payload = {
    "arn": null
}
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
    "order": "73450234",
    "currency": "RUB",
    "status_transaction": "created",
    "created_at": "2022-03-04T08:17:54.000000Z",
    "total": "99.00"
}
 

Request      

POST api/{wallet_uuid}/chargeback

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 93fc2f67-1fd2-3f9f-9626-c17af5824303

Body Parameters

transaction   string  optional  

UUID транзакции

order   string  optional  

Внешний идентификатор (макс 100 символов)

arn   string   

Уникальный номер операции в клиринговом обмене между банками

reason_code   string  optional  

Характеризует причину возникновения Chargeback

Response

Response Fields

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

currency   string   

Валюта

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

created_at   string   

Дата создания в UTC

total   number   

Сумма зачисления

amount   number   

Сумма заказа

type_alias   string   

Тип транзакции (payin - пополнение, payout - выплата, refund - Refund, chargeback - Chargeback)

Отправка дополнительных параметров по транзакции

requires authentication

Дополнительные поля: UZS: sms_code

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/cd9fd14e-5df0-34d6-98d1-a1a79ad1df1a/additional_data" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"addition_data\": []
}"
const url = new URL(
    "https://api.magic-payments.com/api/cd9fd14e-5df0-34d6-98d1-a1a79ad1df1a/additional_data"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "addition_data": []
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/cd9fd14e-5df0-34d6-98d1-a1a79ad1df1a/additional_data';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'addition_data' => [],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/cd9fd14e-5df0-34d6-98d1-a1a79ad1df1a/additional_data'
payload = {
    "addition_data": []
}
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
    "order": "73450234",
    "currency": "RUB",
    "status_transaction": "created",
    "created_at": "2022-03-04T08:17:54.000000Z",
    "total": "99.00"
}
 

Request      

POST api/{wallet_uuid}/additional_data

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: cd9fd14e-5df0-34d6-98d1-a1a79ad1df1a

Body Parameters

transaction   string  optional  

UUID транзакции

order   string  optional  

Внешний идентификатор (макс 100 символов)

addition_data   object  optional  

Дополнительные параметры

sms_code   string  optional  

Код из смс (для UZS)

Response

Response Fields

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

currency   string   

Валюта

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

created_at   string   

Дата создания в UTC

total   number   

Сумма зачисления

amount   number   

Сумма заказа

last_error   string   

Описание последней ошибки (может быть null)

card_mask   string   

Маска карты (может быть null)

payment_details   object   

Реквизиты для оплаты (может быть null)

Оплата счета

requires authentication

Отправка чека и реквизитов плательщика по оплаченному счету

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/2313125b-f99b-3711-8162-915a6b19026a/paid" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"receipt\": {
        \"sender\": \"Иван Иванович 4432\",
        \"file_extension\": \"jpg\",
        \"file_name\": \"image\"
    }
}"
const url = new URL(
    "https://api.magic-payments.com/api/2313125b-f99b-3711-8162-915a6b19026a/paid"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "receipt": {
        "sender": "Иван Иванович 4432",
        "file_extension": "jpg",
        "file_name": "image"
    }
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/2313125b-f99b-3711-8162-915a6b19026a/paid';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'receipt' => [
                'sender' => 'Иван Иванович 4432',
                'file_extension' => 'jpg',
                'file_name' => 'image',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/2313125b-f99b-3711-8162-915a6b19026a/paid'
payload = {
    "receipt": {
        "sender": "Иван Иванович 4432",
        "file_extension": "jpg",
        "file_name": "image"
    }
}
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
    "order": "73450234",
    "currency": "RUB",
    "status_transaction": "created",
    "created_at": "2022-03-04T08:17:54.000000Z",
    "total": "99.00"
}
 

Request      

POST api/{wallet_uuid}/paid

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 2313125b-f99b-3711-8162-915a6b19026a

Body Parameters

transaction   string  optional  

UUID транзакции

order   string  optional  

Внешний идентификатор (макс 100 символов)

receipt   object   

Чек

sender   string   

Реквизиты плательщика Example: Иван Иванович 4432

file_base64   string  optional  

Файл чека в base64

file_extension   string  optional  

Расширение файла чека Example: jpg

file_name   string  optional  

Имя файла чека Example: image

Response

Response Fields

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

currency   string   

Валюта

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

created_at   string   

Дата создания в UTC

total   number   

Сумма зачисления

amount   number   

Сумма заказа

last_error   string   

Описание последней ошибки (может быть null)

card_mask   string   

Маска карты (может быть null)

payment_details   object   

Реквизиты для оплаты (может быть null)

Отмена оплаты по счету

requires authentication

Example request:
curl --request POST \
    "https://api.magic-payments.com/api/754d58b2-4ed2-30cf-bd31-f2fbb1b751e4/cancel" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
const url = new URL(
    "https://api.magic-payments.com/api/754d58b2-4ed2-30cf-bd31-f2fbb1b751e4/cancel"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/754d58b2-4ed2-30cf-bd31-f2fbb1b751e4/cancel';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/754d58b2-4ed2-30cf-bd31-f2fbb1b751e4/cancel'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers)
response.json()

Example response (200):


{
    "uuid": "5a01ba3f-0170-4abd-9b60-f1879f4804c6",
    "order": "73450234",
    "currency": "RUB",
    "status_transaction": "created",
    "created_at": "2022-03-04T08:17:54.000000Z",
    "total": "99.00"
}
 

Request      

POST api/{wallet_uuid}/cancel

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 754d58b2-4ed2-30cf-bd31-f2fbb1b751e4

Body Parameters

transaction   string  optional  

UUID транзакции

order   string  optional  

Внешний идентификатор (макс 100 символов)

Response

Response Fields

uuid   string   

UUID транзакции

order   string   

Внешний идентификатор

currency   string   

Валюта

status_transaction   string   

Статус транзакции (created - создан, working - в обработке, completed - исполнен, error - ошибка)

created_at   string   

Дата создания в UTC

total   number   

Сумма зачисления

amount   number   

Сумма заказа

last_error   string   

Описание последней ошибки (может быть null)

card_mask   string   

Маска карты (может быть null)

payment_details   object   

Реквизиты для оплаты (может быть null)

Профиль

Профиль

requires authentication

Получение информации по всем кошелькам

Example request:
curl --request GET \
    --get "https://api.magic-payments.com/api/profile" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://api.magic-payments.com/api/profile"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/profile';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/profile'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


[
    {
        "uuid": "52a38a2b-fe45-45c8-850c-11f02d7d1620",
        "currency": "RUB",
        "balance": "800.00"
    },
    {
        "uuid": "18ec8ec9-ebc0-494b-9871-eabef9404375",
        "currency": "USD",
        "balance": "100.00"
    }
]
 

Request      

GET api/profile

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

Баланс

requires authentication

Получение баланса кошелька В блоке detailed перечислены балансы: active - активный баланс (транзакции в статусах Выполнен); current - текущий баланс (транзакции в статусах Создан, В обработке, Выполнен); frozen - ролинг-резерв (транзакции с типом Rolling Reserve); payout - выплатной баланс (баланс, доступный для проведения выплат);

Example request:
curl --request GET \
    --get "https://api.magic-payments.com/api/888fb4db-4a5f-3908-9688-d79861d9d203/balance" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://api.magic-payments.com/api/888fb4db-4a5f-3908-9688-d79861d9d203/balance"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/888fb4db-4a5f-3908-9688-d79861d9d203/balance';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/888fb4db-4a5f-3908-9688-d79861d9d203/balance'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


{
    "uuid": "52a38a2b-fe45-45c8-850c-11f02d7d1620",
    "currency": "RUB",
    "balance": "800.00",
    "detailed": {
        "active": "800.00",
        "current": "800.00",
        "frozen": "0.00",
        "payout": "500.00"
    }
}
 

Request      

GET api/{wallet_uuid}/balance

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 888fb4db-4a5f-3908-9688-d79861d9d203

Транзакции

requires authentication

Получение транзакций за период (используется пагинация)

Example request:
curl --request GET \
    --get "https://api.magic-payments.com/api/7038dfc5-218f-3d03-9d48-c2f6c8d2ab5e/history" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://api.magic-payments.com/api/7038dfc5-218f-3d03-9d48-c2f6c8d2ab5e/history"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'https://api.magic-payments.com/api/7038dfc5-218f-3d03-9d48-c2f6c8d2ab5e/history';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.magic-payments.com/api/7038dfc5-218f-3d03-9d48-c2f6c8d2ab5e/history'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


{
"current_page": 1,
"data": [
{
"uuid": "d6a2f3a4-59f2-4a23-a663-e2908bf18020",
"currency": "RUB",
"status_transaction": "created",
"created_at": "2022-03-04T08:17:54.000000Z",
"amount": "10342.22"
},
{
"uuid": "72f9b70c-e51f-4377-8040-77b3a0b0fcd0",
"currency": "RUB",
"status_transaction": "working",
"created_at": "2022-03-04T08:16:54.000000Z",
"amount": "194.45"
},
{
"uuid": "af2c715a-953c-405c-b755-2a11a89a3dad",
"currency": "RUB",
"status_transaction": "completed",
"created_at": "2022-03-04T08:15:54.000000Z",
"amount": "99.00"
},
],
"first_page_url": "http://example.com/api/52a38a2b-fe45-45c8-850c-11f02d7d1620/history?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://example.com/api/52a38a2b-fe45-45c8-850c-11f02d7d1620/history?page=1",
"next_page_url": null,
"path": "http://example.com/api/52a38a2b-fe45-45c8-850c-11f02d7d1620/history",
"per_page": 50,
"prev_page_url": null,
"to": 20,
"total": 20
}
 

Request      

GET api/{wallet_uuid}/history

Headers

Authorization      

Example: Bearer {ACCESS_TOKEN}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

wallet_uuid   string   

UUID кошелька Example: 7038dfc5-218f-3d03-9d48-c2f6c8d2ab5e

Query Parameters

date_from   string  optional  

Дата от (UTC) (в формате d.m.Y)

date_to   string  optional  

Дата до (UTC) (в формате d.m.Y)

page   integer  optional  

Страница пагинации

Response

Response Fields

current_page   integer   

Текущая страница пагинации

data   object[]   

Список транзакций

from   integer   

Отображение записи с номера

to   integer   

Отображение записи до номера

total   integer   

Количество записей всего