Guides

Calculating Payment & Commission

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)