Endpoints

Production (Monero's mainnet)

• https://api.xmrgateway.com
• http://624ydlvn7xixditf6of6smblxhrdnz4e6dm6xe7zxt6hehopek76moqd.onion

Testing (Monero's testnet)

• (Comming soon) https://api-testing.xmrgateway.com

Receive

Create a receiving address

Request

curl -X POST -H 'Content-Type: application/json' \
-d '{"address": "YOUR_MONERO_ADDRESS", "amount": "0.5"}' \
https://api.xmrgateway.com/payments

Response

{
    "id": "TRANSACTION_ID",
    "amount": "0.5",
    "expiration": "2025-07-02T15:04:05Z",
    "paymentAddress": "PAYMENT_ADDRESS",
    "fee": {
        "status": "MONERO_TX_STATUS",
        "percentage": 1,
        "error": "ERROR_MESSAGE",
        "payed": "~0.005"
    },
    "beneficiary": {
        "status": "MONERO_TX_STATUS",
        "error": "ERROR_MESSAGE",
        "payed": "0.495"
    }
}

Legend

• YOUR_MONERO_ADDRESS: This is your Monero wallet address, which you will use to receive funds.
• TRANSACTION_ID: This is the unique identifier for the transaction; you can use it to verify if the payment has been completed.
• PAYMENT_ADDRESS: This is the address you will provide to your client to receive the payment.
• ERROR_MESSAGE: If an error occurs, this message will explain the reason.
• MONERO_TX_STATUS: This indicates the status of the transaction. The possible values are:

  • pending: No funds have been received yet.
  • completed: The transaction was successfully completed.
  • partially-completed: The transaction was completed, but the expected amount was not received from the sender.
  • expired: The transaction has expired; no funds were received.
  • error: The transaction failed; see ERROR_MESSAGE for more details.

Payment Status

Check whether the payment has been received.

Request

curl -X GET https://api.xmrgateway.com/payments/TRANSACTION_ID

Response

{
    "id": "TRANSACTION_ID",
    "amount": "0.5",
    "expiration": "2025-07-02T15:04:05Z",
    "paymentAddress": "PAYMENT_ADDRESS",
    "fee": {
        "status": "MONERO_TX_STATUS",
        "percentage": 1,
        "error": "ERROR_MESSAGE",
        "payed": "~0.005"
    },
    "beneficiary": {
        "status": "MONERO_TX_STATUS",
        "error": "ERROR_MESSAGE",
        "payed": "0.495"
    }
}

Legend

• TRANSACTION_ID: This is the unique identifier for the transaction; you can use it to verify if the payment has been completed.
• PAYMENT_ADDRESS: This is the address you will provide to your client to receive the payment.
• ERROR_MESSAGE: If an error occurs, this message will explain the reason.
• MONERO_TX_STATUS: This indicates the status of the transaction. The possible values are:
  • pending: No funds have been received yet.
  • completed: The transaction was successfully completed.
  • partially-completed: The transaction was completed, but the expected amount was not received from the sender.
  • expired: The transaction has expired; no funds were received.
  • error: The transaction failed; see ERROR_MESSAGE for more details.