Skip to main content
QFPay Checkout supports Card BIN Promotions for online card payments.
This feature allows merchants to offer discounts or promotional campaigns to specific cardholders by matching eligible Card BIN ranges. Card BIN promotions are commonly used for:
  • Bank-issued card campaigns
  • Visa / Mastercard promotions
  • Merchant-funded discounts
  • Limited-time issuer offers
  • Loyalty and co-branded campaigns

​
How Card BIN Promotions Work

A Card BIN Promotion works by matching:
  1. A merchant-defined promotion_tag
  2. Eligible Card BIN ranges
  3. Supported payment methods
  4. Active promotion period
Only transactions meeting all conditions will qualify for the promotion.

​
Key Concepts

​
Supported Scenarios

Examples of supported campaigns:
  • Visa cardholders receive 10% discount
  • Mastercard users receive cashback
  • Specific issuing bank promotions
  • Merchant seasonal campaigns
  • Co-branded partner promotions

​
Prerequisites

Before activating a Card BIN Promotion, merchants must provide the following information to QFPay for pre-registration.

​
Required Information

​
Example Promotion Configuration

​
API Integration

To identify a transaction as part of a promotion campaign, include the promotion_tag in the payment request.

​
Example Request

​
Request Parameters

​
Promotion Matching Behaviour

A transaction qualifies for the promotion only if:
  • promotion_tag is valid
  • Promotion period is active
  • Card BIN matches eligible BIN list
  • Payment method is supported
If any condition fails, the user may receive an eligibility error message during the payment process.

​
Testing & Verification

Before launching the promotion:

​
Test Transactions

Perform test payments using:
  • Eligible Card BINs
  • Non-eligible Card BINs
Verify that:
  • Eligible cards successfully trigger the promotion
  • Non-eligible cards do not receive promotional benefits

​
Error Handling

Ensure your integration properly handles invalid promotion scenarios.

​
Common Scenarios

​
Webhook & Reporting

Merchants may use:
  • QFPay merchant portal
  • Transaction reports
  • Merchant backend logs
to monitor promotion performance and validate eligible transactions. It is recommended to store the promotion_tag in your internal order system for reconciliation purposes.

​
Best Practices

Use unique promotion_tag values for each campaign to simplify reconciliation and reporting.
Test both successful and non-successful matching scenarios before production launch.
Card BIN promotions must be pre-registered with QFPay before use.Transactions with unregistered promotion tags may not qualify for promotional pricing or issuer offers.
If multiple promotions are active simultaneously, ensure the correct promotion_tag is sent for the intended campaign.

​
Launch Process

  1. Submit campaign details to QFPay
  2. Complete integration testing
  3. Receive confirmation from QFPay
  4. Launch campaign during approved promotion period
  5. Monitor transaction behaviour and promotion performance

​
Post-Promotion Review

After the campaign ends, merchants are encouraged to:
  • Review transaction performance
  • Analyze conversion and usage
  • Evaluate eligible BIN performance
  • Share feedback for future campaigns

​
Support

For setup assistance or campaign registration, please contact: technical.support@qfpay.com