> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Management

> Learn how to manage advertiser budget top-ups and payment history.

## Who is this guide for?

This guide is for people who manage payments with an **Admin** account.

* Those who want to check advertisers' payment history
* Those who need to process refund requests
* Those who want to understand how payments relate to budgets

***

## Before you begin

<Note>
  The following requirements must be met:

  * Access to the A2 management console (**Admin** role)
  * Payment management permission (Payment read/write)
</Note>

***

## Understanding the payment flow

When an advertiser tops up their budget, it is processed as follows.

```mermaid theme={null}
flowchart LR
    A[Advertiser requests payment] --> B[Payment processing]
    B --> C{Successful?}
    C -->|Success| D[Budget topped up]
    C -->|Failure| E[Error notice]
    D --> F[Ready to run ads]
```

### Payment status

| Status | English | Meaning |
| - | - | - |
| **Charged** | charged | Payment succeeded and the budget was topped up |
| **Refunding** | refunding | A refund request was received and is in progress |
| **Refunded** | refunded | Refund completed |

```mermaid theme={null}
stateDiagram-v2
    [*] --> Charged
    Charged --> Refunding: Refund request
    Refunding --> Refunded: Refund completed
```

***

## Viewing payment history

### View all payments

1. Go to the **Payments** menu.
2. The full payment history is displayed.

### View payment history for a specific advertiser

1. In the **Payments** menu, click **Filter**.
2. Select an advertiser.
3. Only that advertiser's payment history is displayed.

### Payment information

| Field | English | Description |
| - | - | - |
| **Payment ID** | Payment ID | Unique payment number |
| **Advertiser** | Advertiser | The advertiser who made the payment |
| **Amount** | Amount | The amount paid |
| **Payment method** | Payment Method | Card, bank transfer, etc. |
| **Status** | Status | Charged, Refunding, Refunded |
| **Payment date** | Payment Date | Date and time the payment completed |

***

## Payment methods

Payment methods supported on the A2 platform.

| Payment method | Description |
| - | - |
| **Credit/debit card** | The most common payment method |
| **Bank transfer** | Direct transfer from a bank account |
| **Virtual account** | Deposit to a one-time virtual account number |

***

## Processing refunds

When an advertiser requests a refund, an admin must process it.

### Check refund requests

1. In the **Payments** menu, check for refund requests.
2. Select an item whose status is **Refunding**.

### Refund procedure

1. Review the details of the refund request.
2. Check the advertiser's remaining budget.
3. Click **Approve refund**.
4. The status changes to **Refunded**.

<Warning>
  Check the following before processing a refund:

  * The advertiser's remaining budget is at least the refund amount
  * Budget that has already been spent is not refunded
  * Credits are not eligible for refunds (amounts granted through promotions)
</Warning>

### How refunds affect budget

| Situation | Budget change |
| - | - |
| **Charged** | Budget increases (budget += payment amount) |
| **Refunded** | Budget decreases (budget -= refund amount) |

<Note>
  Refunds are deducted only from **Budget**. **Credit** is granted through promotions and similar programs, so it is not eligible for refunds.
</Note>

***

## Payment access permissions

| Role | What you can do |
| - | - |
| **Advertiser** | View own payment history, request payments |
| **Admin** | View all payment history, process refunds |

***

## Payment activity logs

All payment-related actions are recorded in the activity logs.

| Event | Description |
| - | - |
| Payment created | A new payment occurred |
| Payment status changed | The status changed, for example due to a refund |

→ See [Activity Logs](/guides/platform-admin/en/activity-logs) for details.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can I cancel a payment?">
    Once a payment is complete, you must go through the **refund process** rather than cancel it. Refunds are processed by an admin.
  </Accordion>

  <Accordion title="Are partial refunds supported?">
    The system currently supports **full refunds** only. If you need a partial refund, contact us separately.
  </Accordion>

  <Accordion title="How long is payment history kept?">
    Payment history is retained for **at least 5 years** in accordance with legal requirements.
  </Accordion>

  <Accordion title="How do I get a tax invoice?">
    After the payment completes, a tax invoice is automatically sent to the registered email address. If you need it reissued, contact an admin.
  </Accordion>

  <Accordion title="A refund was requested but the budget is insufficient">
    If the remaining budget is less than the refund amount, the refund cannot be processed. Let the advertiser know about the situation.
  </Accordion>

  <Accordion title="Can I see failed payments?">
    Failed payments are not recorded in the payment history. Ask the advertiser to retry the payment.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.