# Payment Page

The Wallet Payment API enables merchants to process deposits and withdrawals by redirecting users to a payment or payout page with pre-filled information. This guide will help developers understand how to construct the necessary URLs and handle the payment process.

## URL Parameters

| Parameter            | Example                                | Description                                                                   |
| -------------------- | -------------------------------------- | ----------------------------------------------------------------------------- |
| merchant\_id\*       | `796276ad-79f7-11ec-8b3f-005056b3725c` | ID provided to merchant during integration process.                           |
| amount\*             | `1075` when amount is 10.75            | Amount to pay expressed in minor denomination. (not required for payout flow) |
| type\*               | `payout`                               | Required for payout flow.                                                     |
| email                | `john.doe@mail.com`                    | Merchant user email address.                                                  |
| return\_url\*        | `https://merchanr.com?order=ref_1234`  | Return URL use when user cancel or when buy/redeem process is completed.      |
| payer\_id\*          | `f68ddc30-f153-4c23-9eda-9f7b9d1dc1a6` | Merchant customer's unique ID.                                                |
| currency             | `USD`                                  | A valid currency code to execute the payment.                                 |
| description          | `Game Subcription`                     | Order description message.                                                    |
| first\_name          | `John`                                 | Merchant customer's first name.                                               |
| last\_name           | `Doe`                                  | Merchant customer's last name.                                                |
| phone                | `+48123456789` E.164 format.           | Merchant customer's phone number.                                             |
| birthday             | `1989-08-30`                           | Merchant customer's birthdate in format “YYYY-MM-DD”.                         |
| address\_line        | `Street 13`                            | Merchant customer's address line.                                             |
| address\_zip         | `12-345`                               | Merchant customer's address postal code.                                      |
| address\_city        | `Wonderland`                           | Merchant customer's address city.                                             |
| address\_state       | `FL`                                   | Merchant customer's address state using ISO2 code.                            |
| address\_country     | `US`                                   | Merchant customer's address country using ISO2 code.                          |
| personal\_number     | `123456789`                            | Merchant customer's social personal number.                                   |
| citizenship\_country | `US`                                   | Merchant customer's citizenship country using ISO2 code.                      |
| locale               | `en`                                   | One of `en`, `ja` or `pl`. English is default.                                |

*\* This parameter are required.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.convergegate.com/legacy/wallet-payment-page/payment-page.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.