Перейти к содержанию

Отчеты для магазина

Чтобы получить список или количество транзакций, обработанных eComCharge за определенный период для вашего магазина, отправьте запросы согласно описанию ниже.

Запрос должен:

Info

Если ожидаемый отчет может содержать более 1000 транзакций, рекомендуем использовать [API постраничных отчетов](/ru/payment_management/reports/paginated_report/)

Список транзакций для магазина

Запрос

Отправьте POST запрос на https://gateway.ecomcharge.com/api/reports с дополнительным заголовком X-Api-Version: 2 и следующими параметрами:

Параметр Тип Описание
report_params * обязательный
object Секция параметров отчета.
date_type * обязательный
string Тип даты.

Возможные значения:
created_at,
paid_at,
settled_at.
date * обязательный
string Дата в формате YYYY-MM-DD, например 2020-01-01.
status * обязательный
string Статус транзакции.

Возможные значения:
all,
successful,
failed,
pending,
incomplete.
payment_method_type * обязательный
string Способ оплаты.

Возможные значения:
credit_card
time_zone * обязательный
string Часовой пояс в формате, как указан здесь, например Europe/London.
Пример запроса
{
"report_params": {
    "date_type":"created_at",
    "date":"2022-01-27",
    "status":"failed",
    "payment_method_type":"credit_card",
    "time_zone":"Etc/UTC"
}
}
Ответ
Параметр Тип Описание
transactions * обязательный
array Массив транзакций для запрошенного отчета. Каждый элемент представляет собой объект транзакции, набор полей которого зависит от типа платежа и способа оплаты для данной транзакции.
count * обязательный
integer Количество транзакций в запрошенном отчете.
Пример ответа в случае успешной обработки запроса
{
    "transactions": [
        {
            "billing_address": {
                "first_name": null,
                "last_name": null,
                "address": null,
                "country": null,
                "city": null,
                "zip": null,
                "state": null,
                "phone": null,
                "birth_date": null
            },
            "customer": {
                "ip": "127.0.0.1",
                "email": null
            },
            "authorization": {
                "gateway_id": 2,
                "ref_id": null,
                "message": "Card check error",
                "status": "failed",
                "auth_code": null,
                "bank_code": null,
                "rrn": null,
                "billing_descriptor": null
            },
            "credit_card": {
                "holder": "JJJ",
                "token": "f1ed1ac4-875a-48bf-ae15-e2b2092969c1",
                "brand": "visa",
                "last_4": "0000",
                "first_1": "4",
                "bin": "420000",
                "issuer_country": "IT",
                "issuer_name": "INVESTBANK",
                "exp_month": 10,
                "exp_year": 2026,
                "product": "VISA"
            },
            "shop": {
                "id": 1
            },
            "uid": "20527-b7ea8c95f4",
            "id": 28859,
            "payment_method_type": "credit_card",
            "status": "failed",
            "message": null,
            "amount": 1000,
            "discount_rate": 0.0,
            "transaction_rate": 0.0,
            "pay_to_merchant": 0.0,
            "transaction_fee": 0.0,
            "test": false,
            "currency": "USD",
            "description": "Test description",
            "tracking_id": null,
            "type": "authorization",
            "order_id": 27723,
            "created_at": "2022-01-27T13:48:51Z",
            "paid_at": null,
            "settled_at": null,
            "manually_corrected_at": null,
            "additional_data": {
                "customer": {
                    "id": "b17727a9-0632-4454-b639-b941826be36f"
                },
                "request_id": "2a906819-5fbc-4dcb-8aaf-fe7ac17da248",
                "browser": {
                    "screen_width": 1440,
                    "screen_height": 900,
                    "screen_color_depth": 24,
                    "language": "it",
                    "java_enabled": false,
                    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.110 Safari/537.36",
                    "time_zone": -180,
                    "time_zone_name": "Europe/London",
                    "window_height": 744,
                    "window_width": 600,
                    "accept_header": "application/json"
                },
                "vendor": {
                    "name": "CTP",
                    "token": "cb15c0e3d6419c24bda4823b5b32559a2f30c16cdbb30539ade2c449c7cd453c"
                },
                "tdsecure": {
                    "status": "failed",
                    "message": "Card check error",
                    "ve_status": "E",
                    "acs_url": null,
                    "pa_req": null,
                    "md": null,
                    "pa_res_url": "https://processing.ecomcharge.com/process/20527-b7ea8c95f4",
                    "eci": "07",
                    "pa_status": null,
                    "xid": null,
                    "cavv": null,
                    "cavv_algorithm": null,
                    "fail_reason": null,
                    "method_process_url": null
                },
                "avs_cvc": {
                    "avs_verification": {
                        "result_code": null
                    },
                    "cvc_verification": {
                        "result_code": null
                    }
                }
            },
            "three_d_secure_verification": {
                "eci": "07",
                "pa_status": null,
                "xid": null,
                "cavv": null,
                "cavv_algorithm": null,
                "ve_status": "E",
                "message": "Card check error",
                "status": "failed"
            }
        },
        {
            "billing_address": {
                "first_name": "Jane",
                "last_name": "Smith",
                "address": "Gilbert 104",
                "country": "IT",
                "city": "Milan",
                "zip": null,
                "state": null,
                "phone": null,
                "birth_date": null
            },
            "customer": {
                "ip": "127.0.0.1",
                "email": "jahn_test@mial.com"
            },
            "p2p": {
                "gateway_id": 2,
                "ref_id": null,
                "message": "Can't make",
                "status": "failed",
                "auth_code": null,
                "bank_code": null,
                "rrn": null,
                "billing_descriptor": null
            },
            "credit_card": {
                "holder": "Dof Hag",
                "token": "a1e442d1-0633-4f48-b6ab-4dc36d71356d",
                "brand": "master",
                "last_4": "0707",
                "first_1": "5",
                "bin": "515464",
                "issuer_country": null,
                "issuer_name": null,
                "exp_month": 6,
                "exp_year": 2026,
                "product": null
            },
            "shop": {
                "id": 1
            },
            "uid": "20532-cb06cfeeed",
            "id": 28864,
            "payment_method_type": "credit_card",
            "status": "failed",
            "message": null,
            "amount": 100,
            "discount_rate": 0.0,
            "transaction_rate": 0.0,
            "pay_to_merchant": 0.0,
            "transaction_fee": 0.0,
            "test": false,
            "currency": "USD",
            "description": "Test transaction",
            "tracking_id": "tracking_id_000",
            "type": "p2p",
            "order_id": 27728,
            "created_at": "2022-01-27T15:03:01Z",
            "paid_at": null,
            "settled_at": null,
            "manually_corrected_at": null,
            "additional_data": {
                "tdsecure": {
                    "status": "successful",
                    "message": "Authentication Successful",
                    "ve_status": "Y",
                    "acs_url": null,
                    "pa_req": null,
                    "md": null,
                    "pa_res_url": "https://processing.ecomcharge.com/process/20532-cb06cfeeed",
                    "eci": "02",
                    "pa_status": "Y",
                    "xid": "8GamGXlGw6o2QTwXDd2cjz70qr0=",
                    "cavv": "ADlWFgxrq8BtAU6/rKnuAoABFA==",
                    "cavv_algorithm": null,
                    "fail_reason": null,
                    "method_process_url": null
                },
                "verify_p2p": {
                    "status": "failed",
                    "message": "Can't make",
                    "amount": 100,
                    "currency": "USD",
                    "bank_fee": 0.0,
                    "required_fields": {
                        "p_id": null
                    }
                }
            },
            "three_d_secure_verification": {
                "eci": "02",
                "pa_status": "Y",
                "xid": "8GamGXlGw6o2QTwXDd2cjz70qr0=",
                "cavv": "ADlWFgxrq8BtAU6/rKnuAoABFA==",
                "cavv_algorithm": null,
                "ve_status": "Y",
                "message": "Authentication Successful",
                "status": "successful"
            },
            "recipient_card": {
                "holder": "Qwert Qwerty",
                "token": "516638c8-a113-4061-97a1-a58874cd9cd2",
                "brand": "visa",
                "last_4": "3101",
                "first_1": "4",
                "bin": "401200",
                "issuer_country": null,
                "issuer_name": null
            }
        }
    ],
    "count": 2
}

Подсчёт количества транзакций для магазина

Запрос

Отправьте HTTP POST запрос на https://gateway.ecomcharge.com/api/reports/countс дополнительным заголовком X-Api-Version: 3 и следующими параметрами:

Параметр Тип Описание
report_params object
date_type * обязательный
string Тип даты.

Возможные значения:
created_at,
paid_at,
settled_at.
from * обязательный
string Дата начала отчетного периода в формате YYYY-MM-DD hh:mm:ss, например 2020-01-01 12:00:00.
to * обязательный
string Дата конца отчетного периода в формате YYYY-MM-DD hh:mm:ss, например 2020-01-01 15:00:00.
status * обязательный
string Статус транзакции.

Возможные значения:
all,
successful,
failed,
pending,
incomplete.
payment_method_type * обязательный
string Способ оплаты.

Возможные значения:
credit_card
time_zone * обязательный
string Часовой пояс в формате, как указан здесь, например Europe/London.
Пример запроса
{
"report_params": {
    "date_type":"created_at",
    "from":"2022-01-25 00:00:00",
    "to":"2022-01-27 23:59:59",
    "status":"incomplete",
    "payment_method_type":"credit_card",
    "time_zone":"Etc/UTC"
}
}
Ответ
Параметр Тип Описание
transactions object
count * обязательный
integer Количество транзакций в запрошенном отчете.
Пример ответа в случае успешной обработки запроса
{
    "transactions": {
        "count": 2
    }
}