Discount Codes

Discount codes let you offer percentage-based or fixed-amount discounts on payment links. Create individual codes, bulk-generate batches, and validate codes at checkout time.

Discount code management requires admin permission. The /validate endpoint requires read permission, making it safe to call from client-side checkout flows.

Authentication

Authorization: Bearer asp_xxx

Base URL: https://platform-api.anyspend.com/api/v1

Endpoints

List Discount Codes

read

List all discount codes with optional filtering and pagination.

string

Search by code string (case-insensitive partial match).

boolean

Filter by active status. Omit to return all codes.

number

Page number for pagination (default: 1).

number

Results per page (default: 20, max: 100).

cURL
SDK

curl -X GET "https://platform-api.anyspend.com/api/v1/discount-codes?search=SUMMER&active=true&limit=10" \
  -H "Authorization: Bearer asp_xxx"

import { AnySpendClient } from "@b3dotfun/sdk/anyspend";

const client = new AnySpendClient({ apiKey: process.env.ANYSPEND_API_KEY! });
const codes = await client.discountCodes.list({
  search: "SUMMER",
  active: true,
  limit: 10,
});

Response

{
  "success": true,
  "data": [
    {
      "id": "dc_abc123",
      "code": "SUMMER25",
      "type": "percentage",
      "value": 25,
      "payment_link_id": "pl_xyz789",
      "max_uses": 100,
      "current_uses": 42,
      "min_order_amount": "5000000",
      "expires_at": "2026-09-01T00:00:00Z",
      "is_active": true,
      "created_at": "2026-06-01T00:00:00Z",
      "updated_at": "2026-06-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "total_pages": 1
  }
}

Create Discount Code

admin

Create a single discount code.

string

required

The discount code string (e.g., SUMMER25). Must be unique. Automatically uppercased.

string

required

Discount type: percentage or fixed.

number

required

Discount value. For percentage, a number between 1-100. For fixed, the amount in the token’s smallest unit (e.g., 5000000 for 5 USDC).

string

Restrict this code to a specific payment link. If omitted, the code works on all payment links.

number

Maximum number of times this code can be redeemed. Omit for unlimited uses.

string

Minimum order amount required to use this code, in the token’s smallest unit.

string

ISO 8601 expiration timestamp. Omit for a code that never expires.

cURL
SDK

curl -X POST https://platform-api.anyspend.com/api/v1/discount-codes \
  -H "Authorization: Bearer asp_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SUMMER25",
    "type": "percentage",
    "value": 25,
    "payment_link_id": "pl_xyz789",
    "max_uses": 100,
    "min_order_amount": "5000000",
    "expires_at": "2026-09-01T00:00:00Z"
  }'

const code = await client.discountCodes.create({
  code: "SUMMER25",
  type: "percentage",
  value: 25,
  payment_link_id: "pl_xyz789",
  max_uses: 100,
  min_order_amount: "5000000",
  expires_at: "2026-09-01T00:00:00Z",
});

Response

{
  "success": true,
  "data": {
    "id": "dc_abc123",
    "code": "SUMMER25",
    "type": "percentage",
    "value": 25,
    "payment_link_id": "pl_xyz789",
    "max_uses": 100,
    "current_uses": 0,
    "min_order_amount": "5000000",
    "expires_at": "2026-09-01T00:00:00Z",
    "is_active": true,
    "created_at": "2026-02-27T12:00:00Z",
    "updated_at": "2026-02-27T12:00:00Z"
  }
}

Update Discount Code

admin

Update an existing discount code. All fields are optional.

cURL
SDK

curl -X PATCH https://platform-api.anyspend.com/api/v1/discount-codes/dc_abc123 \
  -H "Authorization: Bearer asp_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "max_uses": 200,
    "expires_at": "2026-12-31T23:59:59Z"
  }'

const updated = await client.discountCodes.update("dc_abc123", {
  max_uses: 200,
  expires_at: "2026-12-31T23:59:59Z",
});

Delete Discount Code

admin

Permanently delete a discount code. Active sessions using this code will not be affected.

cURL
SDK

curl -X DELETE https://platform-api.anyspend.com/api/v1/discount-codes/dc_abc123 \
  -H "Authorization: Bearer asp_xxx"

await client.discountCodes.delete("dc_abc123");

Validate Discount Code

read

Validate a discount code against a payment link and order amount. Returns the discount details if valid, or an error message explaining why the code is invalid.

string

required

The discount code to validate.

string

required

The payment link the code is being applied to.

string

required

The order amount in the token’s smallest unit, used to check min_order_amount and calculate the discounted total.

cURL
SDK

curl -X POST https://platform-api.anyspend.com/api/v1/discount-codes/validate \
  -H "Authorization: Bearer asp_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SUMMER25",
    "payment_link_id": "pl_xyz789",
    "amount": "20000000"
  }'

const result = await client.discountCodes.validate({
  code: "SUMMER25",
  payment_link_id: "pl_xyz789",
  amount: "20000000",
});

if (result.valid) {
  console.log("Discount:", result.discount_amount);
  console.log("New total:", result.final_amount);
} else {
  console.log("Invalid:", result.error);
}

Valid Response

{
  "success": true,
  "data": {
    "valid": true,
    "code": "SUMMER25",
    "type": "percentage",
    "value": 25,
    "discount_amount": "5000000",
    "final_amount": "15000000"
  }
}

Invalid Response

{
  "success": true,
  "data": {
    "valid": false,
    "error": "Code has reached maximum number of uses"
  }
}

The validate endpoint does not consume a use. Uses are only counted when a payment is completed with the discount applied.

Batch Create Discount Codes

admin

Bulk-create multiple discount codes at once with shared configuration. Useful for generating promotional campaigns or unique single-use codes.

string[]

required

Array of code strings to create. Each must be unique.

string

required

Discount type applied to all codes: percentage or fixed.

number

required

Discount value applied to all codes.

string

Restrict all codes to a specific payment link.

number

Maximum uses per code. Set to 1 for single-use codes.

string

Minimum order amount for all codes.

string

ISO 8601 expiration timestamp for all codes.

cURL
SDK

curl -X POST https://platform-api.anyspend.com/api/v1/discount-codes/batch \
  -H "Authorization: Bearer asp_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "codes": ["PROMO-A1B2", "PROMO-C3D4", "PROMO-E5F6"],
    "type": "fixed",
    "value": 2000000,
    "payment_link_id": "pl_xyz789",
    "max_uses": 1,
    "expires_at": "2026-06-30T23:59:59Z"
  }'

const batch = await client.discountCodes.batchCreate({
  codes: ["PROMO-A1B2", "PROMO-C3D4", "PROMO-E5F6"],
  type: "fixed",
  value: 2000000,
  payment_link_id: "pl_xyz789",
  max_uses: 1,
  expires_at: "2026-06-30T23:59:59Z",
});

console.log(`Created ${batch.created} codes`);

Response

{
  "success": true,
  "data": {
    "created": 3,
    "codes": [
      { "id": "dc_001", "code": "PROMO-A1B2" },
      { "id": "dc_002", "code": "PROMO-C3D4" },
      { "id": "dc_003", "code": "PROMO-E5F6" }
    ]
  }
}

Discount Code Object

Field	Type	Description
`id`	`string`	Unique identifier (e.g., `dc_abc123`)
`code`	`string`	The discount code string (uppercased)
`type`	`string`	`percentage` or `fixed`
`value`	`number`	Discount value (percentage 1-100, or fixed amount in smallest unit)
`payment_link_id`	`string \| null`	Restricted payment link, or `null` for all links
`max_uses`	`number \| null`	Maximum redemptions, or `null` for unlimited
`current_uses`	`number`	Number of times redeemed so far
`min_order_amount`	`string \| null`	Minimum order amount required
`expires_at`	`string \| null`	ISO 8601 expiration, or `null` for no expiration
`is_active`	`boolean`	Whether the code is currently usable
`created_at`	`string`	ISO 8601 creation timestamp
`updated_at`	`string`	ISO 8601 last update timestamp

Validation Rules

A discount code is considered invalid if any of the following are true:

Condition	Error Message
Code does not exist	`Invalid discount code`
Code is inactive (`is_active: false`)	`Discount code is not active`
Code has expired	`Discount code has expired`
`current_uses >= max_uses`	`Code has reached maximum number of uses`
Code is restricted to a different payment link	`Code is not valid for this payment link`
Order amount is below `min_order_amount`	`Order amount is below minimum required`

Getting Started

React

Order API

Platform API

Platform API Reference

x402

Token

Advanced

Authentication

Endpoints

List Discount Codes

Create Discount Code

Update Discount Code

Delete Discount Code

Validate Discount Code

Batch Create Discount Codes

Discount Code Object

Validation Rules

​Authentication

​Endpoints

​List Discount Codes

​Create Discount Code

​Update Discount Code

​Delete Discount Code

​Validate Discount Code

​Batch Create Discount Codes

​Discount Code Object

​Validation Rules

Authentication

Endpoints

List Discount Codes

Create Discount Code

Update Discount Code

Delete Discount Code

Validate Discount Code

Batch Create Discount Codes

Discount Code Object

Validation Rules