Get Failed Invoices

Description

This method allows external requisites merchants to retrieve a list of their invoices with the status failed This enables providers to track and process failed transactions directly via API

Request URL

https://cactusgino.com/api/supplier/invoices/failed/

HTTP Method

GET

Query Parameters

Parameter	Required	Format	Description	Example
site_id	No	integer	Site ID	12
merchant_id	Yes	string	Mercahnt ID	"test_api_v2"
currency	Yes	string	Currency. Available values: 'USD', 'EUR', 'RUB', 'UAH', 'USDT', 'IDR', 'AZN', 'VND'	demo_request_386961
signature	Yes	string	Signature
from_date	No	datetime	Filter results starting from this date (ISO 8601).	2025-04-01T00:00:00
limit	No	integer	Maximum number of records to return. Default is 100	50

Example Request

JSON

{
    "merchant_id": "test_api_v2",
    "site_id": "101",
    "currency": "USD",
    "signature": "some"
    "from_date": "2025-04-01T00:00:00",
    "limit": "2"
 
}

Response parameters

Field	Description	Example
invoice_id	Invoice ID in our system	34741
amount	Invoice amount	69000.0
currency	Currency of the invoice	RUB
bank_name	Bank's name	Test_bank
card_number	Card/phone/account number	5454545454545454545
phone_number	Contact data	[phone]
date_created	Invoice created date	2025-05-02T11:45:23.556395
date_modified	Invoice modified date	2025-05-02T11:51:19.924307

Example Successful Response

JSON

{
    “success”: true,
    “invoices”: [
        {
            “invoice_id”: 34741,
            “amount”: 69000.0,
            “currency”: “RUB”,
            “status”: “Failed”,
            “bank_name”: “Sber”,
            “card_number”: “4444555566669",
            “phone_number”: “[phone]”,
            “date_created”: “2025-05-02T11:45:23.556395",
            “date_modified”: “2025-05-02T11:51:19.924307"
        },
        {
            “invoice_id”: 34740,
            “amount”: 68000.0,
            “currency”: “RUB”,
            “status”: “Failed”,
            “bank_name”: “Sber”,
            “card_number”: “4444555566669",
            “phone_number”: “[phone]”,
            “date_created”: “2025-05-02T11:45:11.508655",
            “date_modified”: “2025-05-02T11:50:19.854456"
        },
        {
            “invoice_id”: 34739,
            “amount”: 67000.0,
            “currency”: “RUB”,
            “status”: “Failed”,
            “bank_name”: “Sber”,
            “card_number”: “4444555566669",
            “phone_number”: “[phone]”,
            “date_created”: “2025-05-02T11:44:59.833970",
            “date_modified”: “2025-05-02T11:50:19.825179"
        },]
        }