Skip to main content

Vouchers & Promotions

Purpose:
Flexible promotional campaign management with discount validation, application tracking, and performance analytics.

Description:
The promotion system enables sophisticated marketing campaigns through voucher codes, percentage discounts, and conditional offers. It supports various discount types, usage limitations, customer segmentation, and campaign performance tracking. The system integrates with the pricing engine to ensure accurate discount application and prevents fraud through comprehensive validation mechanisms.

Promotional Features:

  • Multiple discount types (percentage, fixed amount, tiered)
  • Customer segment targeting and eligibility rules
  • Usage limitations and expiration management
  • Campaign performance tracking and analytics
  • Fraud prevention and validation mechanisms

Business Value:
Increases customer acquisition and retention, enables targeted marketing campaigns, provides campaign performance insights, prevents discount abuse, and supports revenue optimization through strategic promotional activities.

Get Voucher Information​

GET /v4/vouchers/:voucher_id​

Purpose:
Validates promotional voucher codes and calculates applicable discounts with comprehensive eligibility verification and fraud prevention.

Endpoint Explanation:
This endpoint gets the full voucher information

curl -L 'https://api.rc.saas.bolttech.asia/v4/vouchers/:voucher_id' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
{
  "amount": 50,
  "apply_over_taxes": false,
  "code": "SUMMER2024",
  "conditions": ["country: PT", "partner: bolttech"],
  "description": "50% off on all electronics",
  "partner": {
    "additional_details": {},
    "branch": "string",
    "brand": "default",
    "client_id": "string",
    "name": "bolttech broker",
    "partner_id": "bolttech"
  },
  "payment_properties": {
    "allowed_banks": ["Bank of America", "Chase", "Wells Fargo"],
    "allowed_banks_digits": ["123456", "789012"],
    "allowed_payment_methods": ["credit_card", "debit_card", "bank_transfer"]
  },
  "quantity_used": 5,
  "product": [
    {
      "internal_id": "123e4567",
      "internal_products": [null],
      "metadata": {
        "productGradeLabel": "gold"
      },
      "name": "Car Insurance Gold",
      "price": {
        "amount": 0,
        "commission": {
          "additional_details": {},
          "apply_over_taxes": true,
          "commission_value": 0,
          "description": "string",
          "type": "FIXED",
          "value": "string",
          "rate": 20
        },
        "currency_code": "EUR",
        "discount": [
          {
            "additional_details": {},
            "apply_over_taxes": true,
            "commission_value": 0,
            "description": "string",
            "type": "FIXED",
            "value": "string",
            "rate": 20
          }
        ],
        "premium": {
          "net": 0,
          "total": 0
        },
        "taxes": [
          {
            "description": "Value Added Tax",
            "type": "VAT",
            "value": 0.19,
            "rate": 20
          }
        ]
      },
      "product_id": "PROD-001",
      "product_package": "car-insurance",
      "quote_id": "123456",
      "product_status": "production",
      "provider": "provider123",
      "score": 4.5
    }
  ],
  "terms_and_conditional": {
    "max_discount_value": 0,
    "minimum_purchase_amount": 0,
    "quantity_limit": 0,
    "quantity_used": 0
  },
  "type": "discount",
  "validity": {
    "expires_at": "string",
    "start_at": "string"
  }
}