Getting a list of invoices

The method allows you to get a list of invoices

Getting a list of invoices

POSThttps://ocp.onchainpay.io/api-gateway/get-invoices

Header parameters

Body

application/json

statusarray of enum

Array for filtering orders by status

limitinteger

Number of elements per page

offsetinteger

Number of items to skip

Response

200

Body

application/json

success*boolean

Request success indicator

response*GetInvoicesResponse (object)

The body of the response to the request for a list of invoices

Request

JavaScriptCurl

const response = await fetch('https://ocp.onchainpay.io/api-gateway/get-invoices', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "success": false,
  "response": {
    "invoices": [
      {
        "id": "97bdc6ac-d586-4929-813f-b5b3a05ca8db",
        "advancedBalanceId": "3e8eed11-69a6-40d2-8b1f-d5d1b3f1fd72",
        "externalId": "merchantExternalId123",
        "orderId": "ad71343a-e1e8-4285-a02d-234ab23ef239",
        "orderLink": "https://payment.domain/ad71343a-e1e8-4285-a02d-234ab23ef239",
        "invoiceLink": "https://invoices.domain/97bdc6ac-d586-4929-813f-b5b3a05ca8db",
        "status": "INIT",
        "order": "Order #123456",
        "description": "Payment by order #123456",
        "currency": "USD",
        "amount": "20",
        "receivedNetwork": "USDT",
        "receivedCurrency": "USDT",
        "receivedAmount": "100.32",
        "receivedAmountInInvoiceCurrency": "100.94",
        "rate": "100.32",
        "includeFee": false,
        "additionalFees": [
          "SEPA_WITHDRAWAL"
        ],
        "insurancePercent": "1",
        "slippagePercent": "2",
        "webhookURL": "https://merchant.domain/webhooks/invoice",
        "returnUrl": "https://merchant.domain/",
        "expiresAt": "2024-05-07T11:27:55.612Z",
        "createdAt": "2024-05-07T11:27:25.613Z",
        "currencies": [
          {
            "currency": "USDT",
            "networks": [
              {
                "name": "ethereum",
                "amount": "25"
              }
            ]
          }
        ]
      }
    ],
    "total": "900"
  }
}