Calculating Payment & Commission

Understanding how payments and commissions work for buy gift card transactions is essential for businesses to maximize their profit margins while offering competitive rates to their customers.

Using the Calculate Payment Endpoint

Before processing any gift card transaction, use the Calculate Payment endpoint to get accurate pricing information.

Endpoint Details

POST /api/partners/v1/giftcard-trade/buy/calculate-payment

Request Parameters

  • giftCardSKU (required): The SKU for the gift card you want to buy
  • price (required): The amount on the individual gift card
  • quantity (required): The number of units to order

Example Request

{
  "giftCardSKU": 922,
  "price": 100,
  "quantity": 1
}

Example Response

{
  "USD": 101.05,
  "NAIRA": 98000,
  "CEDIS": 121
}

Understanding the Response

The response shows what your business will pay in different currencies:

  • NAIRA: ₦98,000 (Face value ₦100,000 minus 2% commission)
  • USD: $101.05 (Including processing fees)
  • CEDIS: 121 GHβ‚΅ (Converted amount)

Important: These amounts represent what you pay to Prestmit.


Payment Structure Overview

In a buy gift card transaction, the commission structure works as a discount system where:

  • Face Value: The actual gift card amount (e.g., $100 = ₦100,000)
  • Commission/Discount: Percentage discount given to you as a business partner
  • Business Payment: Reduced amount your business pays to Prestmit
  • Customer Price: What you choose to charge your end customer
  • Markup: Additional profit margin you can add

Basic Payment Calculation

The fundamental structure for buy gift card transactions:

Your Business Payment to Prestmit = Face Value - Commission Discount
Customer Payment to Your Business = Face Value + Markup (optional)
Business Profit = Customer Payment - Business Payment

Example Calculation

Note: All figures are illustrative, not real.

For a $100 gift card (say ₦100,000 naira equivalent):

Step 1: Calculate Business Payment

  • Face Value: ₦100,000
  • Commission/Discount (2%): ₦2,000
  • Your Business Pays Prestmit: ₦98,000

Step 2: Business Sets Customer Price

  • Option A: If you choose to charge face value β†’ Your customer pays ₦100,000
  • Option B: If you choose to add 3% markup β†’ Your customer pays ₦103,000

Step 3: Calculate Business Profit

  • Option A Profit: ₦100,000 - ₦98,000 = ₦2,000 (2% margin)
  • Option B Profit: ₦103,000 - ₦98,000 = ₦5,000 (5% margin)

What’s Next

Next... Let's look at how to manage payment methods.