GET /v1/invoices/{uuid}

Retrieve invoice

Returns the latest state of an invoice, including confirmations.

Parameters

uuid path required

Invoice UUID returned at creation.

Response 200

{
    "uuid": "9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00",
    "status": "confirming",
    "order_id": "INV-1001",
    "title": "Order #1001",
    "amount": "10",
    "currency": "USDT",
    "platform_fee": "0.08",
    "network_fee": "0.35",
    "pay_amount": "10.43",
    "merchant_net": "10",
    "fee_payer": "buyer",
    "network": "TRC20",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "memo": null,
    "checkout_url": "https://zyvopay.com/pay/9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00",
    "qr_svg": "<svg …>",
    "received_amount": "10.43",
    "confirmations": 7,
    "required_confirmations": 19,
    "tx_hash": "a3f1…9c",
    "metadata": {
        "customer_id": 42
    },
    "expires_at": "2026-10-16T22:00:00Z",
    "paid_at": null,
    "created_at": "2026-10-16T21:00:00Z"
}

All requests must be signed — see Authentication.

← Create invoice Retrieve by order ID →

BODY=''
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$ZYVO_SECRET" | cut -d" " -f2)
curl -X GET https://api.zyvopay.com/v1/invoices/9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00 \
  -H "X-Zyvo-Key: $ZYVO_KEY" \
  -H "X-Zyvo-Signature: $SIG"

<?php
// composer require guzzlehttp/guzzle
$client = new \GuzzleHttp\Client(['base_uri' => 'https://api.zyvopay.com/v1/']);
$body = '';
$response = $client->request('GET', 'invoices/9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00', [
    'headers' => [
        'X-Zyvo-Key' => getenv('ZYVO_KEY'),
        'X-Zyvo-Signature' => hash_hmac('sha256', $body, getenv('ZYVO_SECRET')),
        'Content-Type' => 'application/json',
    ],
]);
$data = json_decode((string) $response->getBody(), true);

import crypto from 'node:crypto';

const body = '';
const signature = crypto.createHmac('sha256', process.env.ZYVO_SECRET).update(body).digest('hex');

const res = await fetch('https://api.zyvopay.com/v1/invoices/9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00', {
  method: 'GET',
  headers: {
    'X-Zyvo-Key': process.env.ZYVO_KEY,
    'X-Zyvo-Signature': signature,
    'Content-Type': 'application/json',
  },
});
console.log(await res.json());

import hmac, hashlib, json, os, requests

body = ''
signature = hmac.new(os.environ['ZYVO_SECRET'].encode(), body.encode(), hashlib.sha256).hexdigest()

r = requests.request('GET', 'https://api.zyvopay.com/v1/invoices/9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00', data=body, headers={
    'X-Zyvo-Key': os.environ['ZYVO_KEY'],
    'X-Zyvo-Signature': signature,
    'Content-Type': 'application/json',
})
print(r.json())

package main

import (
	"bytes"
	"crypto/hmac"
	"crypto/sha256"
	"encoding/hex"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(``)
	mac := hmac.New(sha256.New, []byte(os.Getenv("ZYVO_SECRET")))
	mac.Write(body)

	req, _ := http.NewRequest("GET", "https://api.zyvopay.com/v1/invoices/9b1f2c3e-5a4d-4e8f-9c21-7d3b8e6a1f00", bytes.NewReader(body))
	req.Header.Set("X-Zyvo-Key", os.Getenv("ZYVO_KEY"))
	req.Header.Set("X-Zyvo-Signature", hex.EncodeToString(mac.Sum(nil)))
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}