# Paymentwall

### 1. Configure Paymentwall PG settings

Refer to the [**Paymentwall settings**](/docs-en/ready/2.-pg/payment-gateway-settings/undefined-1.md) page to configure the PG settings.

![](/files/6udQH5om2JfEJ7CO3yz1)

### 2. Request payment

To open the payment window, call [JavaScript SDK](/docs-en/sdk/javascript-sdk.md) IMP.**request\_pay**(param, callback).

In PC browsers, <mark style="color:red;">**callback**</mark> is invoked after calling `IMP.request_pay(param, callback)`. In mobile browsers, the page is redirected to <mark style="color:red;">**m\_redirect\_url**</mark>.

{% tabs %}
{% tab title="Authenticated payment request" %}
{% code title="Javascript SDK" %}

```javascript
IMP.request_pay({
    pg : 'paymentwall',
    pay_method : 'card', // In Paymentwall, the payment method is activated based on the country IP. (Can be omitted)
    merchant_uid : '{Merchant created Order ID}', // Example: order_no_0001
    name : 'Order name: Test payment request',
    amount : 14000,
    currency : 'KRW'  // required
    buyer_email : 'iamport@siot.do',  // required 
    buyer_name : 'Jack Son',   // Must include a space between Firstname Lastname
    buyer_tel : '010-1234-5678',
    buyer_addr : 'Shinsa-dong, Gangnam-gu, Seoul',
    buyer_postcode : '123-456',
    m_redirect_url : '{Mobile only - URL to redirect to after payment approval}', // Example: https://www.my-service.com/payments/complete/mobile
    bypass: {
      // Set this for Terminal 3 only, Defualt: general payment window opens
      widget_code: "t3_1",  
      // Set to enable specific payment method, set to 'all'(default) to enable all methods supported by your country
      ps : "all",
      country_code:"DE"  // Set this to enable all payment methods supported by the country
    },
}, function(rsp) { // callback logic
	//* ...Omitted... *//
});
```

{% endcode %}

###

### Key parameter description

**`pg`** <mark style="color:red;">**\***</mark>**&#x20;&#x20;**<mark style="color:green;">**s**</mark><mark style="color:green;">**tring**</mark>

**PG code**

* If not specified and this is the only PG setting that exists, `default PG` is automatically set.
* If there are multiple PG settings, set to **`paymentwall`**.

**`pay_method`** <mark style="color:green;">**s**</mark><mark style="color:green;">**tring**</mark>

**Payment method code (Can be omitted)**

You can manage your payment methods by enabling Project from the [Paymentwall website](https://api.paymentwall.com/).

(Payment methods are enabled based on your country IP by default)

**`merchant_uid`** <mark style="color:red;">**\***</mark>**&#x20;**<mark style="color:green;">**s**</mark><mark style="color:green;">**tring**</mark>

**Order ID**

Must be unique for each request.

**`amount`** <mark style="color:red;">**\***</mark>**&#x20;**<mark style="color:purple;">**integer**</mark>

**Payment amount**

Must be an integer (not string)

**`buyer_name`**<mark style="color:red;">**`*`**</mark><mark style="color:green;">**`string`**</mark>

**`Customer name`**

**`buyer_email`**<mark style="color:red;">**`*`**</mark><mark style="color:green;">**`string`**</mark>

**`Customer email address`**&#x20;

**`currency`**<mark style="color:red;">**`*`**</mark><mark style="color:green;">**`string`**</mark>

**`Currency`**&#x20;

**`bypass`**

**`Paymentwall specific parameter`**

* **`widget_code` :**  Set this to <mark style="color:red;">**t3\_1**</mark> for Terminal 3 only, Defualt: general payment window
* **`ps` :**  Set to enable specific payment method. For available codes, refer to [**Payment system short codes**](https://docs.paymentwall.com/reference/payment-system-shortcodes).   Example: `kakaopaykr` = Kakao Pay
* **country\_code** : Payment methods are shown based on this code. ([**Country codes**](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))
  {% endtab %}

{% tab title="Non-authenticated payment request" %}
**Preparing for service**&#x20;
{% endtab %}
{% endtabs %}


---

# 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://portone.gitbook.io/docs-en/payment-integration-by-pg/payment-gateways/paymentwall.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.