Transactions

Get Invoice Transactions List

get

Retrieves all cryptocurrency transactions associated with an invoice

Query parameters

vinteger · enumrequired

API version, must be 1

Available options:

invoice_idstring · uuidrequired

ID of the invoice to get transactions for

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.simplepay.ai/transactions?v=1&invoice_id=123e4567-e89b-12d3-a456-426614174000'

200

401

404

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": 1,
    "status": "processing",
    "created_at": "2025-04-02T04:59:59.132Z",
    "updated_at": "2025-04-02T04:59:59.132Z",
    "expire_at": "2025-04-02T04:59:59.132Z",
    "cryptocurrency": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "symbol": "text",
      "name": "text",
      "decimals": 1,
      "stable": true,
      "rates": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    },
    "network": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "symbol": "text",
      "name": "text",
      "type": "EVM"
    }
  }
]

List of transactions successfully retrieved

Get Transaction Details

get

Retrieves detailed information about a specific transaction

Path parameters

idstring · uuidrequired

Transaction ID

Query parameters

vinteger · enumrequired

API version, must be 1

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.simplepay.ai/transaction/{id}?v=1'

200

401

404

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": 1,
  "status": "processing",
  "created_at": "2025-04-02T04:59:59.132Z",
  "updated_at": "2025-04-02T04:59:59.132Z",
  "expire_at": "2025-04-02T04:59:59.132Z",
  "cryptocurrency": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "decimals": 1,
    "stable": true,
    "rates": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "network": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "type": "EVM"
  }
}

Transaction details successfully retrieved

Create Transaction

post

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

Query parameters

vinteger · enumrequired

API version, must be 1

Available options:

Body

invoice_idstring · uuidrequired

ID of the invoice to create transaction for

fromstringrequired

Cryptocurrency address that will send the payment

cryptocurrencystringrequired

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

networkstringrequired

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.simplepay.ai/transaction?v=1' \
  --header 'Content-Type: application/json' \
  --data '{
    "invoice_id": "123e4567-e89b-12d3-a456-426614174000",
    "from": "text",
    "cryptocurrency": "text",
    "network": "text"
  }'

201

400

401

404

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": 1,
  "status": "processing",
  "created_at": "2025-04-02T04:59:59.132Z",
  "updated_at": "2025-04-02T04:59:59.132Z",
  "expire_at": "2025-04-02T04:59:59.132Z",
  "cryptocurrency": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "decimals": 1,
    "stable": true,
    "rates": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "network": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "type": "EVM"
  }
}

Transaction successfully created

Cancel Transaction

delete

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

Path parameters

idstring · uuidrequired

Transaction ID to cancel

Query parameters

vinteger · enumrequired

API version, must be 1

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.simplepay.ai/transaction/{id}?v=1'

200

401

404

409

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": 1,
  "status": "processing",
  "created_at": "2025-04-02T04:59:59.132Z",
  "updated_at": "2025-04-02T04:59:59.132Z",
  "expire_at": "2025-04-02T04:59:59.132Z",
  "cryptocurrency": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "decimals": 1,
    "stable": true,
    "rates": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "network": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "text",
    "name": "text",
    "type": "EVM"
  }
}

Transaction successfully cancelled