Transactions

Get Invoice Transactions List

Retrieves all cryptocurrency transactions associated with an invoice

GEThttps://api.simplepay.ai/transactions

Query parameters

Response

200401404

List of transactions successfully retrieved

Body

application/json

idstring (uuid)

Unique identifier of the transaction

invoice_idstring (uuid)

ID of the associated invoice

fromstring

Sender's cryptocurrency address

tostring

Recipient's cryptocurrency address

ratestring (decimal)

Exchange rate at the time of transaction

amountnullable string (decimal)

Amount of cryptocurrency to be sent

hashnullable string

Transaction hash on the blockchain

blocknullable integer

Block number where the transaction was confirmed

statusenum

Current status of the transaction:

• processing - transaction is initiated
• success - transaction is confirmed
• canceled - transaction was cancelled
• rejected - transaction was rejected by blockchain

processingsuccesscanceledrejected

created_atstring (date-time)

Timestamp when the transaction was created

updated_atstring (date-time)

Timestamp of the last transaction update

expire_atnullable string (date-time)

Timestamp when the transaction will expire

cryptocurrencyCryptocurrency (object)

Represents a cryptocurrency

networkNetwork (object)

Represents a blockchain network

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.simplepay.ai/transactions?v=1&invoice_id=123e4567-e89b-12d3-a456-426614174000', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "invoice_id": "123e4567-e89b-12d3-a456-426614174000",
    "from": "text",
    "to": "text",
    "rate": "text",
    "amount": "text",
    "hash": "text",
    "block": 0,
    "status": "processing",
    "created_at": "2025-01-22T05:17:02.984Z",
    "updated_at": "2025-01-22T05:17:02.984Z",
    "expire_at": "2025-01-22T05:17:02.984Z",
    "cryptocurrency": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "symbol": "text",
      "name": "text",
      "decimals": 0,
      "stable": false
    },
    "network": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "symbol": "text",
      "name": "text",
      "type": "EVM"
    }
  }
]

Get Transaction Details

Retrieves detailed information about a specific transaction

GEThttps://api.simplepay.ai/transaction/{id}

Path parameters

id*string (uuid)

Transaction ID

Query parameters

Response

200401404

Transaction details successfully retrieved

Body

application/json

idstring (uuid)

Unique identifier of the transaction

invoice_idstring (uuid)

ID of the associated invoice

fromstring

Sender's cryptocurrency address

tostring

Recipient's cryptocurrency address

ratestring (decimal)

Exchange rate at the time of transaction

amountnullable string (decimal)

Amount of cryptocurrency to be sent

hashnullable string

Transaction hash on the blockchain

blocknullable integer

Block number where the transaction was confirmed

statusenum

Current status of the transaction:

• processing - transaction is initiated
• success - transaction is confirmed
• canceled - transaction was cancelled
• rejected - transaction was rejected by blockchain

processingsuccesscanceledrejected

created_atstring (date-time)

Timestamp when the transaction was created

updated_atstring (date-time)

Timestamp of the last transaction update

expire_atnullable string (date-time)

Timestamp when the transaction will expire

cryptocurrencyCryptocurrency (object)

Represents a cryptocurrency

networkNetwork (object)

Represents a blockchain network

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.simplepay.ai/transaction/{id}?v=1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "invoice_id": "123e4567-e89b-12d3-a456-426614174000",
  "from": "text",
  "to": "text",
  "rate": "text",
  "amount": "text",
  "hash": "text",
  "block": 0,
  "status": "processing",
  "created_at": "2025-01-22T05:17:02.984Z",
  "updated_at": "2025-01-22T05:17:02.984Z",
  "expire_at": "2025-01-22T05:17:02.984Z",
  "cryptocurrency": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "decimals": 0,
    "stable": false
  },
  "network": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "type": "EVM"
  }
}

Create Transaction

Initiates a new cryptocurrency transaction for an invoice. Specifies the sending address and cryptocurrency to be used.

POSThttps://api.simplepay.ai/transaction

Query parameters

Body

application/json

invoice_id*string (uuid)

ID of the invoice to create transaction for

from*string

Cryptocurrency address that will send the payment

cryptocurrency*string

Symbol of the cryptocurrency to use (e.g., BTC, ETH)

network*string

Blockchain network to use (e.g., ethereum, tron)

Response

201400401404

Transaction successfully created

Body

application/json

idstring (uuid)

Unique identifier of the transaction

invoice_idstring (uuid)

ID of the associated invoice

fromstring

Sender's cryptocurrency address

tostring

Recipient's cryptocurrency address

ratestring (decimal)

Exchange rate at the time of transaction

amountnullable string (decimal)

Amount of cryptocurrency to be sent

hashnullable string

Transaction hash on the blockchain

blocknullable integer

Block number where the transaction was confirmed

statusenum

Current status of the transaction:

• processing - transaction is initiated
• success - transaction is confirmed
• canceled - transaction was cancelled
• rejected - transaction was rejected by blockchain

processingsuccesscanceledrejected

created_atstring (date-time)

Timestamp when the transaction was created

updated_atstring (date-time)

Timestamp of the last transaction update

expire_atnullable string (date-time)

Timestamp when the transaction will expire

cryptocurrencyCryptocurrency (object)

Represents a cryptocurrency

networkNetwork (object)

Represents a blockchain network

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.simplepay.ai/transaction?v=1', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "invoice_id": "123e4567-e89b-12d3-a456-426614174000",
      "from": "text",
      "cryptocurrency": "text",
      "network": "text"
    }),
});
const data = await response.json();

Response

201

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "invoice_id": "123e4567-e89b-12d3-a456-426614174000",
  "from": "text",
  "to": "text",
  "rate": "text",
  "amount": "text",
  "hash": "text",
  "block": 0,
  "status": "processing",
  "created_at": "2025-01-22T05:17:02.984Z",
  "updated_at": "2025-01-22T05:17:02.984Z",
  "expire_at": "2025-01-22T05:17:02.984Z",
  "cryptocurrency": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "decimals": 0,
    "stable": false
  },
  "network": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "type": "EVM"
  }
}

Cancel Transaction

Cancels a pending transaction. Only transactions that haven't been confirmed on the blockchain can be cancelled.

DELETEhttps://api.simplepay.ai/transaction/{id}

Path parameters

id*string (uuid)

Transaction ID to cancel

Query parameters

Response

200401404409

Transaction successfully cancelled

Body

application/json

idstring (uuid)

Unique identifier of the transaction

invoice_idstring (uuid)

ID of the associated invoice

fromstring

Sender's cryptocurrency address

tostring

Recipient's cryptocurrency address

ratestring (decimal)

Exchange rate at the time of transaction

amountnullable string (decimal)

Amount of cryptocurrency to be sent

hashnullable string

Transaction hash on the blockchain

blocknullable integer

Block number where the transaction was confirmed

statusenum

Current status of the transaction:

• processing - transaction is initiated
• success - transaction is confirmed
• canceled - transaction was cancelled
• rejected - transaction was rejected by blockchain

processingsuccesscanceledrejected

created_atstring (date-time)

Timestamp when the transaction was created

updated_atstring (date-time)

Timestamp of the last transaction update

expire_atnullable string (date-time)

Timestamp when the transaction will expire

cryptocurrencyCryptocurrency (object)

Represents a cryptocurrency

networkNetwork (object)

Represents a blockchain network

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.simplepay.ai/transaction/{id}?v=1', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "invoice_id": "123e4567-e89b-12d3-a456-426614174000",
  "from": "text",
  "to": "text",
  "rate": "text",
  "amount": "text",
  "hash": "text",
  "block": 0,
  "status": "processing",
  "created_at": "2025-01-22T05:17:02.984Z",
  "updated_at": "2025-01-22T05:17:02.984Z",
  "expire_at": "2025-01-22T05:17:02.984Z",
  "cryptocurrency": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "decimals": 0,
    "stable": false
  },
  "network": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "type": "EVM"
  }
}