# 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.*