API Documentation for Retrieving Invoice Data via API

This section of the documentation outlines how to retrieve information about a specific invoice using Crypto Payments from E-Gates.

Retrieving an Invoice

This method allows you to retrieve detailed information about a specific invoice using its unique identifier.

Request

URL: /api/external/v1/gateway/payment-invoice/{invoiceId} Method: GET

Parameters:

• invoiceId (string, required) - Unique identifier of the invoice.

Example Request:

GET /api/external/v1/gateway/payment-invoice/2794c4d4-6feb-4b46-9334-1849af7b1a0f

Response

Successful response:

• success (boolean) - Indicates whether the request was successful.

• status (null) - Response status (may be null).

• response (object) - Object containing detailed information about the requested invoice.

  • id (string) - Invoice identifier.

  • invoice (string) - Unique identifier of the invoice.

  • ticker (string) - Cryptocurrency ticker of the invoice.

  • currencyName (string) - Name of the invoice currency.

  • networkName (string) - Network name (e.g., "ERC-20").

  • payment_method (string) - Payment method used for the invoice.

  • actualAmount (string) - Actual payment amount received.

  • invoiceAmount (string) - Original invoice amount.

  • amountTransaction (string) - Amount of the transaction.

  • feeTransaction (string) - Transaction fee.

  • address (string) - Cryptocurrency address for receiving payment.

  • sysAddress (null or string) - System address.

  • hash (string) - Transaction hash.

  • type (string) - Invoice type (e.g., "CRYPTO").

  • status (string) - Invoice status (e.g., "SUCCESS").

  • sender_name (string) - Sender's name.

  • purpose_of_payment (string) - Purpose of the payment.

  • order_number (string) - Order number associated with the invoice.

  • createdAt (string) - Date and time when the invoice was created.

  • updatedAt (string) - Date and time of the last invoice update.

  • expireAt (string) - Date and time when the invoice expires.

  • redirectContinue (string) - URL to continue to after a successful payment.

Example Successful Response:

{
    "success": true,
    "status": null,
    "response": {
        "id": "1-13",
        "invoice": "2794c4d4-6feb-4b46-9334-1849af7b1a0f",
        "ticker": "USDT",
        "currencyName": "Tether USD",
        "networkName": "ERC-20",
        "payment_method": "ETHER",
        "actualAmount": "100001.000000000000000000",
        "invoiceAmount": "100",
        "amountTransaction": "99000.99000000",
        "feeTransaction": "1000.010000000000000000",
        "address": "0xC1Dc25f17d2d767A103F881dC5c363E9Df3e01D8",
        "sysAddress": null,
        "hash": "test_hash1",
        "type": "CRYPTO",
        "status": "SUCCESS",
        "sender_name": "user name",
        "purpose_of_payment": "payment for items",
        "order_number": "14556-HF1000-KL5",
        "createdAt": "2023-08-11 21:12:00",
        "updatedAt": "2023-08-11 16:11:29",
        "expireAt": "2023-08-12 00:12:00",
        "redirectContinue": "http://test.com/success"
    },
    "errors": null
}

Note: In case of errors, the errors field will contain relevant information.