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.

Authentication

bash
Authorization: Bearer asp_xxx

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

Endpoints

List Discount Codes

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

typescript
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

json
{
  "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

bash
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"
  }'

typescript
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

json
{
  "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

bash
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"
  }'

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

---

Delete Discount Code

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

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

---

Validate Discount Code

bash
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"
  }'

typescript
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

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

Invalid Response

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

---

Batch Create Discount Codes

bash
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"
  }'

typescript
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

json
{
  "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