Get invoice history (GET)

REQUEST

The query is an HTTP GET request where your provided api key will be used as an http header.

END POINT

https://usdc.nonstopay.net/api/invoices/history/

HEADERS

API-KEY (Use the api key we’ve sent to you here).

Example

“API-KEY: 0d8d8e89a6cdcd”

QUERY PARAMS

Parameter name	Example	Info
status	PAID	status : ● PAID for all paid invoices ● UNPAID for all unpaid invoices ● WAITING for all waiting approval invoices ● EXPIRED for all invoices with OPENED or CREATED statuses more than 14 days old ● ALL for all invoices
from	2023-06-01	start date filter
to	2023-06-19	end date filter
order	ASC	● ASC : ascending order by date ● DESC : descending order with respect to dates
page	2	Each page contains a maximum of 50 records

---

RESPONSE

Our service will return a JSON object.

For errors

• 50001 : API-KEY required

• 50007 : Invalid API-KEY

• 50010 : No IP is linked to your account. Please enter them in your profile page and API block

• 50006 : You can not use this API from this IP address

• 50012 : Invalid order. order must be ASC or DESC

Example :

{ “errorCode”: 50002, “errorMessage” : “id required” }

Success response

• 0

  • { "errorCode":0, "status":"PAID", "from":"2023-06-01", "to":"2023-06-19", "page":2, "order":"DESC", "list":[ { "id":"1932", "email":"[e-mail]", "status":"PAID","amount":"1.00", "symbol":”USD”, "create_date":"2023-06-15 10:39:34", "status_date":"2023-06-15 10:40:38", "tx_hash": "0xda4fd344e6310738db73dabdb42a213a38f14d2379b13c27fe86f8452002d4c5", "exchange_currency_symbol":"USDC", "paid_amount":"1.00", "merchant_amount":"0.900", "fee_amount":"0.100", "ip":"102.117.124.254", "country":"United Arab Emirates", "success_url":null, "pending_url":null, "cancel_url":null} ], ,"total":"51" }

Example :

{"errorCode":0,"status":"PAID","from":"2023-06-01","to":"2023-06-19","page":2,
"order":"DESC","list":[ {"id":"1932", "email":"[e-mail]",
"status":"PAID","amount":"1.00", "symbol":”USD”, "create_date":"2023-06-15 10:39:34",
"status_date":"2023-06-15 10:40:38","tx_hash":
"0xda4fd344e6310738db73dabdb42a213a38f14d2379b13c27fe86f8452002d4c5",
"exchange_currency_symbol":"USDC","paid_amount":"1.00",
"merchant_amount":"0.900","fee_amount":"0.100", "ip":"102.177.124.254","country":"United
Arab Emirates","success_url":null,"pending_url":null, "cancel_url":null} ],"total":"51"}

---

SAMPLE REQUEST CODE

<?php
    // First, please install the php-curl-class library through composer
    // git repository: https://github.com/php-curl-class/php-curl-class
    // Installation: composer require php-curl-class/php-curl-class
    require __DIR__ . '/vendor/autoload.php';
    use Curl\Curl;
    $API_KEY = ''; // Your API-KEY (We sent it to you)
    
    // URL to get an invoice status (IP-restricted call)
    $url = 'https://usdc.nonstopay.net/api/invoices/history/';
    /*

    * Data to POST
    */
    $data = [
     'status' => 'PAID',
     'from' => '2023-06-01',
     'to' => '2023-06-19',
     'order' => 'ASC',
     'page' => 2,
    ];
    $curl = new Curl();
    $curl->setHeader('Content-Type', 'application/json');
    $curl->setHeader('API-KEY', $API_KEY);
    $curl->post($url, $data);
    if ($curl->error) {
        echo 'Error: ' . $curl->errorMessage . "\n";
    } else {
        echo 'Data server received via POST:' . "\n";
        if( $curl->response->errorCode == 0 ){
            var_dump( $curl->response);
             /*
             Response example :
            {
             "errorCode":0,
             "status":"PAID",
             "from":"2023-06-01",
             "to":"2023-06-19",
             "page":2,
             "order":"DESC",
             "list":[
             {
             "id":"1932",
             "email":"[e-mail]",
             "status":"PAID","amount":"1.00",
             "symbol":”USD”,
             "create_date":"2023-06-15 10:39:34",
             "status_date":"2023-06-15 10:40:38",
             "tx_hash":
            "0xda4fd344e6310738db73dabdb42a213a38f14d2379b13c27fe86f8452002d4c5",
             "exchange_currency_symbol":"USDC",
             "paid_amount":"1.00",
             "merchant_amount":"0.900",
             "fee_amount":"0.100",
             "ip":"102.117.124.254",
             "country":"United Arab Emirates",
             "success_url":null,
             "pending_url":null,
             "cancel_url":null}
             ],
            ,"total":"51"
            }
             */
        }else{
            var_dump( $curl->response);
         /*
         Response example :
         {“errorCode”:50007, “errorMessage”: “invalid API-KEY”}
         */
        }
    }