Invoice Information

To get information about a created invoice, send a GET request to the following URL:

GET

https://api.payp.io/&/v2/invoice/(invoice id)

When sending the request, you will receive complete information about the invoice in the response.

Response

200 - Success

{
    "id": "da1e630e-7d2a-452e-8eb5-8ea2fab89fce",
    "payStatus": "none",
    "createdAt": "2025-03-31T10:25:20.088Z",
    "amount": 100.4,
    "currency": "USD",
    "feeByClient": true,
    "sendToEmail": false,
    "timeout": "2025-05-20T22:25:20.083Z",
    "status": "open",
    "title": "New from 31.03.2025, 10:24:57",
    "link": "https://i.payp.io/pay/da1e630e-7d2a-452e-8eb5-8ea2fab89fce",
    "methods": [
        "BTC",
        "USDT-TRC20",
        "USDT-ERC20",
        "LTC",
        "DOGE",
        "DASH",
        "BCH",
        "TRX",
        "BNB",
        "ETH",
        "SOL",
        "ETC"
    ],
    "fee": 0,
    "shop": {
        "title": "Test",
        "failUrl": null,
        "successUrl": "https://site.com/successful-payment"
    }
}

401 - Unauthorized

// Check the invoice ID correctness 
{
    "status": 400,
    "name": "BadRequestError",
    "message": "no any invoice",
    "details": {}
}

Request Examples

These examples show how to send a request to get information about an invoice.

cURL

curl --location 'https://api.payp.io/&/v2/invoice/da1e630e-7d2a-452e3-8eb5-8ea2fab89fce' \

PHP

<?php
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://api.payp.io/&/v2/invoice/da1e630e-7d2a-452e3-8eb5-8ea2fab89fce',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => '',
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'Content-Type: application/json'
      ),
    ));
    
    $response = curl_exec($curl);
    
    curl_close($curl);
    echo $response;

?>

Python

import requests
import json

url = "https://api.payp.io/&/v2/invoice/da1e630e-7d2a-452e3-8eb5-8ea2fab89fce"
headers = {
    "Authorization": "Token <API KEY>",
    "Content-Type": "application/json"
}

data = {}
response = requests.get(url, headers=headers, json=data)

# Check the response
if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Fail:", response.status_code, response.text)

JavaScript

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

let invoiceId = 'da1e630e-7d2a-452e3-8eb5-8ea2fab89fce'

const requestOptions = {
    method: "GET",
    headers: myHeaders,
    redirect: "follow"
};

fetch(`https://api.payp.io/&/v2/invoice/${invoiceId}`, requestOptions)
    .then((response) => response.text())
    .then((result) => console.log(result))
    .catch((error) => console.error(error));