Prices

This API allows you to create and manage prices for your products. Prices define the cost and billing structure (one-time or recurring) for your products, enabling customers to make cryptocurrency payments.

The price object

string

Unique identifier with price_ prefix (e.g., price_abc123def456).

integer

The price amount in cents (e.g., 2999 for $29.99).

string

The associated product’s ID.

boolean

Whether the price is active. Defaults to true on creation.

object

Recurring billing configuration. null for one-time prices.

Show recurring properties

string

Billing interval: day, week, month, or year.

integer

Number of intervals between charges.

string

When the price was created (ISO 8601).

string

When the price was last updated (ISO 8601).

One-time price example

{
  "id": "price_def456ghi789",
  "amount": 4999,
  "product_id": "prod_xyz789ghi012",
  "active": true,
  "recurring": null,
  "created_at": "2024-01-02T10:30:00Z",
  "updated_at": "2024-01-02T10:30:00Z"
}

Recurring price example

{
  "id": "price_abc123def456",
  "amount": 2999,
  "product_id": "prod_xyz789ghi012",
  "active": true,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-01T12:00:00Z"
}

List prices

GET /v1/prices

Retrieves a paginated list of all prices in your account.

integer

default:"1"

Page number for pagination. Results are returned 25 items per page.

curl https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN"

Response

{
  "prices": [
    {
      "id": "price_abc123def456",
      "amount": 2999,
      "product_id": "prod_xyz789ghi012",
      "active": true,
      "recurring": {
        "interval": "month",
        "interval_count": 1
      },
      "created_at": "2024-01-01T12:00:00Z",
      "updated_at": "2024-01-01T12:00:00Z"
    },
    {
      "id": "price_def456ghi789",
      "amount": 4999,
      "product_id": "prod_xyz789ghi012",
      "active": true,
      "recurring": null,
      "created_at": "2024-01-02T10:30:00Z",
      "updated_at": "2024-01-02T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pages": 3,
    "count": 67
  }
}

Get price

GET /v1/prices/:id

Retrieves a specific price by ID.

string

required

The price’s ID (e.g., price_abc123def456).

curl https://api.gettrxn.com/v1/prices/price_abc123def456 \
  -H "Authorization: Bearer $TRXN_TOKEN"

Response (recurring)

{
  "id": "price_abc123def456",
  "amount": 2999,
  "product_id": "prod_xyz789ghi012",
  "active": true,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-01T12:00:00Z"
}

Response (one-time)

{
  "id": "price_def456ghi789",
  "amount": 4999,
  "product_id": "prod_xyz789ghi012",
  "active": true,
  "recurring": null,
  "created_at": "2024-01-02T10:30:00Z",
  "updated_at": "2024-01-02T10:30:00Z"
}

Create price

POST /v1/prices

Creates a new price for a product in your account.

string

required

The product’s ID (e.g., prod_abc123def456). Must belong to your account.

integer

required

The price amount in cents (e.g., 2999 for $29.99). Must be 0 or greater.

object

Object containing recurring billing configuration. Omit for one-time prices.

Show recurring properties

string

required

Billing interval. One of: day, week, month, year.

integer

required

Number of intervals between charges. Must be a positive integer (e.g., 1 for monthly, 3 for quarterly).

Create a one-time price

curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 4999
  }'

Create a monthly recurring price

curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 2999,
    "recurring": {
      "interval": "month",
      "interval_count": 1
    }
  }'

Create a quarterly recurring price

curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 9999,
    "recurring": {
      "interval": "month",
      "interval_count": 3
    }
  }'

Response

{
  "id": "price_new123price456",
  "amount": 2999,
  "product_id": "prod_abc123def456",
  "active": true,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "created_at": "2024-01-15T14:30:00Z",
  "updated_at": "2024-01-15T14:30:00Z"
}

Validation errors

Amount is required

{
  "errors": {
    "amount": ["can't be blank"]
  }
}

Amount must be non-negative

{
  "errors": {
    "amount": ["must be greater than or equal to 0"]
  }
}

Interval is required for recurring prices

{
  "errors": {
    "interval": ["is required for recurring prices. Valid options are: \"day\", \"week\", \"month\", or \"year\""]
  }
}

Interval count is required

{
  "errors": {
    "interval_count": ["is required for recurring prices"]
  }
}

Interval count must be a positive integer

{
  "errors": {
    "interval_count": ["must be greater than zero and only integer values are valid"]
  }
}

Update price

PATCH /v1/prices/:id

Updates a price’s active status. Only the active attribute can be modified after creation.

string

required

The price’s ID (e.g., price_abc123def456).

boolean

Whether the price is active. Set to false to deactivate.

curl -X PATCH https://api.gettrxn.com/v1/prices/price_abc123def456 \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "active": false
  }'

Response

{
  "id": "price_abc123def456",
  "amount": 2999,
  "product_id": "prod_xyz789ghi012",
  "active": false,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-15T16:45:00Z"
}

Delete price

DELETE /v1/prices/:id

Deletes a price from your account.

This action is irreversible and will also delete associated subscriptions and line items.

string

required

The price’s ID (e.g., price_abc123def456).

curl -X DELETE https://api.gettrxn.com/v1/prices/price_abc123def456 \
  -H "Authorization: Bearer $TRXN_TOKEN"

Returns 204 No Content on successful deletion.

Recurring billing intervals

Prices can be configured for recurring billing with flexible intervals:

Configuration	interval	interval_count
Daily	`day`	`1`
Weekly	`week`	`1`
Bi-weekly	`week`	`2`
Monthly	`month`	`1`
Quarterly	`month`	`3`
Semi-annually	`month`	`6`
Yearly	`year`	`1`

Recurring billing examples

Weekly subscription ($9.99/week)

curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 999,
    "recurring": {
      "interval": "week",
      "interval_count": 1
    }
  }'

Quarterly subscription ($49.99 every 3 months)

curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 4999,
    "recurring": {
      "interval": "month",
      "interval_count": 3
    }
  }'

Annual subscription ($99.99/year)

curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 9999,
    "recurring": {
      "interval": "year",
      "interval_count": 1
    }
  }'

Integration example

# 1. Create a product
curl -X POST https://api.gettrxn.com/v1/products \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Premium Course"}'

# Response: {"id": "prod_abc123def456", "name": "Premium Course", ...}

# 2. Create a one-time price
curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 19999
  }'

# Response: {"id": "price_onetime123", "amount": 19999, "recurring": null, ...}

# 3. Create a monthly subscription price
curl -X POST https://api.gettrxn.com/v1/prices \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_abc123def456",
    "amount": 2999,
    "recurring": {
      "interval": "month",
      "interval_count": 1
    }
  }'

# Response: {"id": "price_monthly123", "amount": 2999, "recurring": {...}, ...}

Sandbox support

The API respects sandbox scoping. If your API token is associated with a sandbox, you can only access prices for products created in that sandbox.

Introduction

Core resources

Billing

Crypto

Webhooks

The price object

One-time price example

Recurring price example

List prices

Get price

Create price

Create a one-time price

Create a monthly recurring price

Create a quarterly recurring price

Validation errors

Update price

Delete price

Recurring billing intervals

Recurring billing examples

Integration example

Sandbox support

​The price object

​One-time price example

​Recurring price example

​List prices

​Get price

​Create price

​Create a one-time price

​Create a monthly recurring price

​Create a quarterly recurring price

​Validation errors

​Update price

​Delete price

​Recurring billing intervals

​Recurring billing examples

​Integration example

​Sandbox support

The price object

One-time price example

Recurring price example

List prices

Get price

Create price

Create a one-time price

Create a monthly recurring price

Create a quarterly recurring price

Validation errors

Update price

Delete price

Recurring billing intervals

Recurring billing examples

Integration example

Sandbox support