Affiliate & Withdrawals

Menu path: Admin -> Affiliate & Withdrawals

This section manages two different admin jobs:

• affiliate and bonus records
• customer withdrawal processing

Important naming note

Some older project code still uses the word transaction.

In the admin panel, this section is now named Affiliate & Withdrawals because that is easier to understand.

Use the pages like this:

• Affiliate Bonus Overview: quick dashboard for affiliate bonus activity
• Affiliate Bonus List: full list of non-withdrawal bonus records
• Withdrawal History: all withdrawal records
• Pending Withdrawal Requests: only withdrawals that still need admin action
• Transaction Record: the full details page for one bonus or one withdrawal record

Main pages

• Affiliate Bonus Overview
• Affiliate Bonus List
• Withdrawal History
• Pending Withdrawal Requests
• Transaction Record

Where these records come from

This section contains records created in different ways:

• the system creates bonus records such as referral bonus, exchange bonus, signup bonus, or admin bonus
• customers create withdrawal requests from the customer dashboard
• admins review and complete those withdrawal requests from this admin section

What you can do

• monitor affiliate bonus performance
• review all bonus records
• review all withdrawal records
• open only pending withdrawals as a working queue
• open one record and check full details
• complete or decline a withdrawal request
• review customer, exchange, history, and system information

Affiliate Bonus Overview

This page is a dashboard, not the full record list.

Use it when you want a quick picture before opening the tables.

It shows sections such as:

• Affiliate Bonus Records: total affiliate-related bonus rows
• Paid: paid affiliate-related entries
• Confirmed: confirmed bonus entries
• Pending: affiliate-related records waiting for final action
• Top Affiliate Earners by Transaction Count
• Type & Status Breakdown
• Latest Affiliate Bonus Records

Important overview note

This dashboard focuses on affiliate-related bonus types such as:

• exchange_bonus
• refer_bonus

If you want the wider non-withdrawal list, use Affiliate Bonus List.

That list can also include records such as:

• signup_bonus
• admin_bonus

Affiliate Bonus List page

This page is the full list of non-withdrawal bonus records.

It shows columns such as:

• Date
• Reference
• Customer
• Type
• Amount
• Status
• Action

What the columns mean

• Date: when the record was created
• Reference: record number
• Customer: linked customer
• Type: bonus source such as referral, exchange, signup, or admin bonus
• Amount: bonus amount
• Status: current state of that record
• Action: view or delete

What this page is for

Use Affiliate Bonus List when you need to:

• find one bonus by reference
• check bonus type and status
• open the full details page
• review bonus history for one customer

Withdrawal History page

This page shows all withdrawal records, not only pending ones.

Use it when you need:

• completed withdrawal history
• declined withdrawal history
• older payout records
• a full withdrawal audit view

Pending Withdrawal Requests page

This is the most important daily work page for payout handling.

It shows only withdrawal records with Pending status.

Use this page when:

• your team is processing new payout requests
• you want to avoid mixing completed records with open requests
• you want a clean queue for finance or operations staff

Transaction Record page

Open one record from any list when you need the full details.

This page is used for both:

• bonus records
• withdrawal records

It has three main tabs:

• Summary
• History
• System Info

Summary tab

The Summary tab contains these main sections:

• Customer
• Invoice
• Payment Information
• Withdrawal Update Form for withdrawal records only

Customer card

This area shows:

• customer name
• email
• phone
• customer verification icon
• referred-by information when available

If the record belongs to a linked customer, the customer name opens the customer profile.

Invoice card

This area shows:

• Reference ID
• Status
• linked Exchange, when available
• Date Added
• Last Update

Use it when:

• support asks for the record number
• you need to verify the current record state
• you want to see whether the record is linked to a real exchange

Payment Information card

This area can show:

• Payment Type
• Payment Method
• Payment Details
• Withdrawal Amount
• Transaction Amount
• Transaction Commission
• Reason

What each payment field means

Field	What it means	When it appears
Payment Type	The source of the record	Shown for all records
Payment Method	The selected withdrawal method	Usually shown for withdrawal records
Payment Details	Customer payout account details	Usually shown for withdrawal records
Withdrawal Amount	The original withdrawal request amount	Shown for withdrawal records
Transaction Amount	Final processed payout amount	Shown after admin fills it
Transaction Commission	Processing fee deducted or applied	Shown after admin fills it
Reason	Explanation for decline or admin note	Shown when a reason exists

Withdrawal Update Form

This form appears only when the record type is withdrawal.

Bonus records do not show this form.

Use it to process or decline a customer payout request.

Field guide

Field	What it means	Validation or good input
Transaction Amount	Final amount sent to the customer	Required. Must be a number greater than 0
Transaction Fee	Processing fee for this payout	Required. Use 0 if there is no fee
Transaction Hash	External payout reference or transfer ID	Optional, but strongly recommended when the payout is sent
Status	New withdrawal status	Required. Choose Pending, Paid, or Declined
Reason	Explanation for the decision	Required when the status is Declined

How to use the withdrawal update form

• use Pending if the request still needs review or payout action
• use Paid when the withdrawal has actually been completed
• use Declined when the payout request is rejected

Transaction Hash

Use Transaction Hash for the real transfer reference when the payout system gives one.

Good examples:

• blockchain transfer hash
• payment processor transfer ID
• manual payout reference number

Status guide

This section can show different statuses depending on the record type.

Status	Meaning	Where it is most common
Pending	Request or record is waiting for final review	Bonus records and withdrawal requests
Confirmed	Bonus is accepted and added	Bonus records
Paid	Withdrawal has been completed	Withdrawal records
Declined	Request or withdrawal is rejected	Withdrawal records and some bonus records

History tab

The History tab shows the status timeline for one record.

It usually includes:

• Date Added
• Comment
• Order Status
• Processor

Use this tab when:

• you want to know who changed the status
• another admin already worked on the record
• you want to review earlier decisions before changing the record again

System Info tab

This tab can show environment details such as:

• IP address
• browser or device information
• request domain
• location-related IP details when available

Important note:

• customer-created withdrawal requests usually contain system information
• auto-created bonus records may not show the same level of system information

How customer withdrawal requests are created

Pending withdrawals normally come from the customer dashboard withdrawal form.

The normal customer flow works like this:

1. Customer opens the withdrawal page
2. Customer chooses a withdrawal method
3. Customer enters the withdrawal amount
4. Customer enters payout account details
5. If withdrawal captcha is enabled, customer completes captcha
6. The request is submitted
7. The system creates a Pending withdrawal record
8. The record appears in Pending Withdrawal Requests

Customer withdrawal form details

The customer-facing withdrawal form includes these main fields:

Field	What it means	Validation or good input
Withdraw To	Customer payout method	Required. Must be one of the allowed withdrawal gateways
Withdraw Amount	Requested payout amount	Required. Must be numeric and follow the minimum rules
Payment Details	Customer payout account information	Required. Keep it clear and complete
Captcha	Anti-spam and abuse check	Required only when withdrawal captcha is enabled

Customer withdrawal validation notes

• the amount must not be below the minimum per transaction
• the customer balance must be high enough
• the requested amount must not exceed the available balance
• the customer total balance must meet the minimum payout rule
• payment details are required

Common mistakes

• opening Withdrawal History when you really want Pending Withdrawal Requests
• thinking Affiliate Bonus Overview contains every non-withdrawal bonus type
• marking a withdrawal as Paid before you enter the final amount and payout reference
• declining a withdrawal without a clear reason
• using the wrong payout method details
• allowing withdrawal on a gateway that should not be used for payout
• setting bonus and withdrawal limits incorrectly in settings, then customers cannot submit requests

If admin update fails

Check these points first:

• Transaction Amount is numeric and greater than 0
• Transaction Fee is numeric and not negative
• Status is selected
• Transaction Hash is not too long
• Reason is filled when the status is Declined

If customer withdrawal submission fails

Check these points first:

• a withdrawal method is selected
• the amount is numeric
• the amount is not below the minimum per transaction
• the requested amount does not exceed the current balance
• the customer meets the minimum payout requirement
• payment details are filled correctly
• captcha is completed if withdrawal captcha is enabled

Best practice

• open Pending Withdrawal Requests first for daily payout work
• use Affiliate Bonus Overview for trends and Affiliate Bonus List for full record search
• always enter a real payout reference when a withdrawal is completed
• write a clear reason when you decline a payout
• review Bonus & Withdraw, Payment Gateway, and Notification Settings together

Related pages

• Customer
• Exchange
• Payment Gateway
• Bonus & Withdraw
• Notification Settings
• ReCaptcha Settings