Ping++

https://www.pingxx.com/docs
Admin
Ping++ is a next-generation payment system that enables mobile and web applications to integrate...
Tokens:770,468
Snippets:2,741
Trust Score:9.6
Update:5 months ago
Show doc for...
Tokens:
Raw
### Create QPay Charge (Python)

Source: https://www.pingxx.com/docs/server/basic_transaction/charge_refunds/charge.html

This Python example demonstrates creating a charge for the 'qpay' channel. It uses a dictionary to pass charge parameters, including extra device information. Ensure the Ping++ Python SDK is installed and imported.

```python
ch = pingpp.Charge.create(
    order_no='123456789',
    amount= 200000, #订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
    app=dict(id='app_1Gqj58ynP0mHeX1q'),
    channel='qpay',
    currency='cny',
    client_ip='127.0.0.1',
    subject='Your Subject',
    body='Your Body',
    extra=dict(
        device ='ios'
    )
)
```

--------------------------------

### Alipay Lite Payment

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay?account=true

Initiate an Alipay Lite payment for an order. This example shows the basic setup for the channel.

```APIDOC
## Alipay Lite Payment

### Description
Initiate an Alipay Lite payment for an order. This example shows the basic setup for the channel.

### Method
POST

### Endpoint
/v1/orders/{order_id}/pay

### Parameters
#### Path Parameters
- **order_id** (string) - Required - The ID of the order to pay.

#### Request Body
- **charge_order_no** (string) - Optional - A unique identifier for the charge, generated by the merchant.
- **charge_amount** (integer) - Required - The amount to be charged in the smallest currency unit (e.g., cents).
- **channel** (string) - Required - The payment channel to use, e.g., "alipay_lite".
- **extra** (object) - Optional - Channel-specific parameters for Alipay Lite.

### Request Example
```json
{
  "charge_order_no": "2011708070000007521",
  "charge_amount": 100,
  "channel": "alipay_lite",
  "extra": {}
}
```

### Response
#### Success Response (200)
- **order** (object) - The updated order object with payment details.

#### Response Example
```json
{
  "id": "order_12345",
  "amount": 100,
  "currency": "cny",
  "order_no": "2011708070000007521",
  "created": 1499999999,
  "paid": false,
  "object": "order",
  "livemode": false,
  "extra": {},
  "channel": "alipay_lite",
  "subject": null,
  "body": null,
  "description": null,
  "metadata": {},
  "amount_refunded": 0,
  "refunded_amount": 0,
  "succeed_url": null,
  "fail_url": null,
  "charge": {
    "id": "ch_abc123",
    "object": "charge",
    "created": 1499999999,
    "livemode": false,
    "paid": false,
    "refunded": 0,
    "app": "app_12345",
    "channel": "alipay_lite",
    "order_no": "2011708070000007521",
    "amount": 100,
    "amount_settle": 100,
    "currency": "cny",
    "transaction_no": null,
    "refunds": [],
    "failure_code": null,
    "failure_msg": null,
    "description": null,
    "metadata": {},
    "extra": {},
    "amount_refunded": 0,
    "amount_settle_refunded": 0,
    "succeed_url": null,
    "fail_url": null,
    "last_payment_error": null,
    "payment_method": null,
    "fee": 0,
    "fee_settle": 0,
    "third_party_fee": null,
    "third_party_fee_settle": null,
    "customer": null,
    "description_extra": null,
    "discounts": [],
    "balance_transaction": null,
    "balance_transaction_settle": null,
    "payment_url": "https://qr.alipay.com/...?"
  }
}
```
```

--------------------------------

### Java: Initiate Order Payment with QPay

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay?account=true

Initiates an order payment using the Ping++ Java SDK for the QPay channel. This example demonstrates setting up payment parameters and calling the `Order.pay` method.

```java
Map<String, Object> params = new HashMap<>();
```

--------------------------------

### Go SDK Example for Order Payment

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

Example of how to initiate an order payment using the Ping++ Go SDK.

```APIDOC
## Go SDK Example for Order Payment

### Description
This Go code snippet demonstrates how to use the Ping++ SDK to pay for an order.

### Method
`order.Pay(orderID, orderPayParams)`

### Parameters
#### Path Parameters
- **orderID** (string) - Required - The ID of the order to pay.

#### Request Body (OrderPayParams)
- **Charge_amount** (*int64) - Required - The amount to charge.
- **Channel** (string) - Required - The payment channel.
- **Extra** (map[string]interface{}) - Optional - Channel-specific extra parameters.

### Request Example
```go
func (c *OrderDemo) Pay() (*pingpp.Order, error) {
	var chargeAmount int64 = 1
	orderPayParams := &pingpp.OrderPayParams{
		Charge_amount: &chargeAmount,
		Channel:       c.demoChannel,
		Extra:         common.ChargeExtra[c.demoChannel],
	}
	return order.Pay(c.demoOrderID, orderPayParams)
}
```
```

--------------------------------

### Create Charge Object in Node.js

Source: https://www.pingxx.com/docs/server/basic_transaction/charge_refunds/charge.html

This Node.js example shows how to create a charge object with a callback function to handle the response. Make sure the Ping++ Node.js SDK is installed.

```javascript
pingpp.charges.create({
    subject: "Your Subject",
    body: "Your Body",
    amount: 200000,//订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
    order_no: "123456789",
    channel: "qpay_pub",
    currency: "cny",
    client_ip: "127.0.0.1",
    app: {id: "app_1Gqj58ynP0mHeX1q"},
    extra: {
        attach : "Ping++ 分店",
        limit_pay : "no_balance",
        promotion_tag : "level_tag=xxx&sale_tag=xxx",
        device_info : "13467007045764"
    }
}, function(err, charge) {
    // YOUR CODE
});                        
```

--------------------------------

### Pay for an Order (Java)

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay?account=true

Initiates an order payment in Java. This example shows how to set up the payment parameters for a specified channel and amount.

```java
Map<String, Object> params = new HashMap<>();
params.put("channel", "wx_wap");
params.put("charge_amount", 100);
Order order = Order.pay("2001708220000281981", params); 


```

```java
Map<String, Object> params = new HashMap<>();
params.put("channel", "wx_lite");
params.put("charge_amount", 100);
Order order = Order.pay("2001708220000281981", params); 


```

--------------------------------

### Install Ping++ Node.js SDK

Source: https://www.pingxx.com/docs/server

Install the Ping++ Node.js SDK using npm. You can either install it directly or after downloading the source code.

```bash
npm install pingpp
```

--------------------------------

### Order Payment with Qpay

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay?account=true

Initiate payment for an order using the Qpay channel. This example shows how to set up payment parameters for Qpay, including device information.

```APIDOC
## Order Payment with Qpay

### Description
Initiate payment for an order using the Qpay channel. This example shows how to set up payment parameters for Qpay, including device information.

### Method
`pingpp.Order.pay(order_id, params)`

### Parameters
#### Request Body
- **order_id** (string) - Required - The ID of the order to pay.
- **params** (object) - Required - Payment parameters.
  - **charge_amount** (integer) - Required - The amount to charge.
  - **channel** (string) - Required - The payment channel, e.g., `qpay`.
  - **extra** (object) - Optional - Channel-specific extra parameters.
    - **device** (string) - Optional - The device type (e.g., 'ios').

### Request Example (PHP)
```php
<?php
// 商品订单支付
$order_id = '2011708070000007521';
$params = [
    'charge_order_no' => substr(md5(time()), 0, 10),
    'charge_amount'     => 100,
    'channel' => 'qpay',
    'extra' => [
         		'device' => 'ios']
];
try {
    $pay = \Pingpp\Order::pay($order_id, $params);
    echo $pay;
} catch (\Pingpp\Error\Base $e) {
    if ($e->getHttpStatus() != null) {
        header('Status: ' . $e->getHttpStatus());
        echo $e->getHttpBody();
    } else {
        echo $e->getMessage();
    }
}
exit;
?>
```

### Request Example (Java)
```java
Map<String, Object> params = new HashMap<>();
params.put("channel", "qpay");
params.put("charge_amount", 100);
Map<String, Object> extra = new HashMap<>(); // extra: 根据不同渠道传入相应的参数
extra.put("device", "ios");
params.put("extra", extra);
Order order = Order.pay("2001708220000281981", params);
```
```

--------------------------------

### Build and Install Ping++ Ruby Gem from Source

Source: https://www.pingxx.com/docs/server

Build and install the Ping++ Ruby SDK from source. This involves building the gem file and then installing it.

```bash
gem build pingpp.gemspec
gem install pingpp-<VERSION>.gem
```

--------------------------------

### Install Ping++ Ruby SDK via Gem

Source: https://www.pingxx.com/docs/server

Install the Ping++ Ruby SDK using the gem command. Ensure you have Ruby and RubyGems installed.

```bash
gem install pingpp
```

--------------------------------

### Create Charge (Go)

Source: https://www.pingxx.com/docs/server/basic_transaction/charge_refunds/charge.html

Example of creating a charge using the Go SDK. Shows how to construct the charge parameters, including order details, amount, app, channel, currency, client IP, subject, body, and extra information.

```APIDOC
## Create Charge (Go)

### Description
This Go code snippet demonstrates how to create a charge using the Ping++ Go SDK. It details the structure for passing charge parameters, including channel-specific extra data.

### Method
POST (Implied by SDK usage)

### Endpoint
Not explicitly defined, but typically a charges endpoint.

### Parameters
- **Order_no** (string) - Required - Unique order number.
- **App** (pingpp.App) - Required - Application details.
  - **Id** (string) - Required - Application ID.
- **Amount** (integer) - Required - Total order amount in cents (e.g., 100 for 1 CNY).
- **Channel** (string) - Required - Payment channel (e.g., `alipay_wap`).
- **Currency** (string) - Required - Currency code (e.g., `cny`).
- **Client_ip** (string) - Required - IP address of the client making the request.
- **Subject** (string) - Required - Subject of the transaction.
- **Body** (string) - Required - Body or description of the transaction.
- **Extra** (map[string]interface{}) - Optional - Additional channel-specific parameters.
  - **success_url** (string) - Optional - URL to redirect to on success.
  - **cancel_url** (string) - Optional - URL to redirect to on cancellation.

### Request Example
```go
extra := make(map[string]interface{})
//success_url 和 cancel_url 在本地测试不要写 localhost ，写 127.0.0.1，URL 后面不要加自定义参数
extra["success_url"] = "http://example.com/success"
extra["cancel_url"] = "http://example.com/cancel"
params := &pingpp.ChargeParams{
    Order_no:  "123456789",
    App:       pingpp.App{Id: "app_1Gqj58ynP0mHeX1q"},
    Amount:    100,//订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
    // 2016 年 6 月 16 日（不含当日）之前登录 Ping++ 管理平台填写支付宝手机网站的渠道参数的商户，请更新接口：https://help.pingxx.com/article/174737
    Channel:   "alipay_wap",
    Currency:  "cny",
    Client_ip: "127.0.0.1",
    Subject:   "Your Subject",
    Body:      "Your Body",
    Extra:     extra,
}
//返回的第一个参数是 charge 对象，你需要将其转换成 json 给客户端，或者客户端接收后转换。
ch, err := charge.New(params)
```
```

--------------------------------

### Install Ping++ PHP SDK via Composer

Source: https://www.pingxx.com/docs/server

Use Composer to manage the Ping++ PHP SDK. Ensure you have Composer installed and then run the installation command.

```bash
composer require pingplusplus/pingpp-php
```

--------------------------------

### Create QPay Charge (Java)

Source: https://www.pingxx.com/docs/server/basic_transaction/charge_refunds/charge.html

This Java example demonstrates creating a charge for the 'qpay' channel. It utilizes a Map to pass charge parameters, including extra device information. Ensure the Ping++ Java SDK is correctly integrated.

```java
Map<String, Object> chargeParams = new HashMap<String, Object>();
chargeParams.put("order_no",  "123456789");
chargeParams.put("amount", 200000);//订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
Map<String, String> app = new HashMap<String, String>();
app.put("id", "app_1Gqj58ynP0mHeX1q");
chargeParams.put("app", app);
chargeParams.put("channel",  "qpay");
chargeParams.put("currency", "cny");
chargeParams.put("client_ip",  "127.0.0.1");
chargeParams.put("subject",  "Your Subject");
chargeParams.put("body",  "Your Body");
Map<String, String> extra = new HashMap<String, String>();
extra.put("device", "ios");
chargeParams.put("extra", extra);
Charge.create(chargeParams);
```

--------------------------------

### Java SDK Example for Order Payment

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

Example of how to initiate an order payment using the Ping++ Java SDK.

```APIDOC
## Java SDK Example for Order Payment

### Description
This Java code snippet demonstrates how to use the Ping++ SDK to pay for an order.

### Method
`Order.pay(orderId, params)`

### Parameters
#### Path Parameters
- **orderId** (string) - Required - The ID of the order to pay.

#### Request Body (Map<String, Object>)
- **channel** (string) - Required - The payment channel.
- **charge_amount** (int) - Required - The amount to charge.
- **extra** (Map<String, Object>) - Optional - Channel-specific extra parameters.
  - **result_url** (string) - Required for some channels.
  - **p_no** (string) - Required for some channels.
  - **seq** (string) - Required for some channels.
  - **m_uid** (string) - Required for some channels.
  - **mobile** (string) - Required for some channels.

### Request Example
```java
Map<String, Object> params = new HashMap<>();
params.put("channel", "cmb_wallet");
params.put("charge_amount", 100);
Map<String, Object> extra = new HashMap<>(); // extra: 根据不同渠道传入相应的参数
extra.put("result_url", "https://example.com/result");
extra.put("p_no", "2016062901");
extra.put("seq", "2016062901");
extra.put("m_uid", "2016062901");
extra.put("mobile", "18512343456");
params.put("extra", extra);
Order order = Order.pay("2001708220000281981", params); 
```
```

--------------------------------

### Go Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of initiating a recharge request using Go.

```APIDOC
```go
	extra := make(map[string]interface{})
  	extra["product_category"] = "1"
  	extra["identity_id"] = "Your identity_id"
  	extra["identity_type"] = 1
  	extra["terminal_type"] = 1
  	extra["terminal_id"] = "Your terminal_id"
  	extra["user_ua"] = "Your user_ua"
  	extra["result_url"] = "http://example.com/result"
	rechargeParams := &pingpp.RechargeParams{
		User: "1477895856250",
		Charge: pingpp.RechargeCharge{
			Amount:  10,

```

--------------------------------

### Ruby Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of initiating a recharge request using Ruby.

```APIDOC
```ruby
	params = {
	:user => get_user_id,
	:charge => {
		:order_no => order_no,
		:channel => "yeepay_wap", # 支付渠道
		:client_ip => "127.0.0.1", # 发起支付请求客户端的 IP 地址，格式为 IPV4，如: 127.0.0.1
		:amount => 100, # 订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
		:body => "Your Body",
		:subject => "You Subject",
		:extra => {
            :product_category => "1",
            :identity_id => "Your identity_id",
            :identity_type => 1,
            :terminal_type => 1,
            :terminal_id => "Your terminal_id",
            :user_ua => "Your user_ua",
            :result_url => "http://example.com/result"
			} 
	},
	:description => "充值描述"
}
 
o = Pingpp::Recharge.create(
	params,
	{ :app => get_app_id } # App 信息
)

```
```

--------------------------------

### PHP SDK Example for Order Payment

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

Example of how to initiate an order payment using the Ping++ PHP SDK.

```APIDOC
## PHP SDK Example for Order Payment

### Description
This PHP code snippet demonstrates how to use the Ping++ SDK to pay for an order.

### Method
`\Pingpp\Order::pay(order_id, params)`

### Parameters
#### Path Parameters
- **order_id** (string) - Required - The ID of the order to pay.

#### Request Body (array)
- **charge_order_no** (string) - Optional - A unique order number for the charge.
- **charge_amount** (integer) - Required - The amount to charge.
- **channel** (string) - Required - The payment channel.
- **extra** (array) - Optional - Channel-specific extra parameters.
  - **result_url** (string) - Required for some channels.
  - **p_no** (string) - Required for some channels.
  - **seq** (string) - Required for some channels.
  - **m_uid** (string) - Required for some channels.
  - **mobile** (string) - Required for some channels.

### Request Example
```php
// 商品订单支付
$order_id = '2011708070000007521';
$params = [
    'charge_order_no' => substr(md5(time()), 0, 10),
    'charge_amount'     => 100,
    'channel' => 'cmb_wallet',
    'extra' => [
        		'result_url' => 'https://example.com/result',
        		'p_no'=> '2016062901',
        		'seq'=>'2016062901',
        		'm_uid'=>'2016062901',
        		'mobile'=>'18512343456'
		]
];
try {
    $pay = \Pingpp\Order::pay($order_id, $params);
    echo $pay;
} catch (\Pingpp\Error\Base $e) {
    if ($e->getHttpStatus() != null) {
        header('Status: ' . $e->getHttpStatus());
        echo $e->getHttpBody();
    } else {
        echo $e->getMessage();
    }
}
exit;
```
```

--------------------------------

### Java: Initiate wx_pub_qr Payment Request

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

Creates and pays for an order using the wx_pub_qr channel in Java. Requires setting up parameters including channel and extra information.

```java
Map<String, Object> params = new HashMap<>();
params.put("channel", "wx_pub_qr");
params.put("charge_amount", 100);
Map<String, String> extra = new HashMap<String, String>();
extra.put("product_id", "Your ProductId");
params.put("extra", extra);
Order order = Order.pay("2001708220000281981", params);

```

--------------------------------

### Python Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of initiating a recharge request using Python.

```APIDOC
```python
    params = {
        "user": "user_test_01",
        "charge": {
            "amount": 100,
            "channel": "yeepay_wap",
            "order_no": str(int(random.uniform(100000000, 200000000))),
            "subject": "Your subject",
            "body": "Your body",
            "time_expire": int(time.time()) + 3600,
            "client_ip": "127.0.0.1",
            "extra": {
            	"product_category"='1',
            	"identity_id"='Your identity_id',
            	"identity_type"=1,
            	"terminal_type"=1,
            	"terminal_id"='Your terminal_id',
            	"user_ua"='Your user_ua',
            	"result_url"='http://example.com/result'
			}
        },
        # "user_fee": 0,
        "balance_bonus": {
            "amount": 100,
        },
        "from_user": "user_test_02",
        "description": "Your description",
        "metadata": {}
    }
    recharge = pingpp.Recharge.create(**params)

```
```

--------------------------------

### Node.js Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of initiating a recharge request using Node.js.

```APIDOC
```javascript
	var charge_extra = require('../charge_extra');
	var order_no = new Date().getTime().toString().substr(0, 10);
	var channel = 'yeepay_wap'; 
	var extra = charge_extra(channel);
	var params = {
		'user': 'user_test_02',// 充值目标用户 ID, 必传
		'user_fee': 10,// 用户充值收取的手续费，单位分，不得大于 amount，不可和 balance_bonus[amount] 同时传，默认 0。可选
		'description': 'Recharge description.',// 描述, 可选
		'charge': {
			'amount': 30,// 用户实际支付金额，单位分, 必传
			'channel': channel,// 支付使用的第三方支付渠道, 必传
			'order_no': order_no,// 商户订单号，适配每个渠道对此参数的要求，必须在商户系统内唯一, 必传
			'client_ip': '127.0.0.1',// 客户端的 IP，IPv4，默认 127.0.0.1, 可选
			'subject': 'Recharge subject',// 充值标题，该参数最长为 32 个 Unicode 字符, 必传
			'body': 'Recharge body',// 充值描述信息，该参数最长为 128 个 Unicode 字符, 必传
			'extra': extra // extra: 根据不同渠道传入相应的参数
		}
	};
	pingpp.recharge.create(APP_ID, params, function(err, recharge) {
		if (err != null) {
			console.log('pingpp.recharge.create fail:', err)
		}
		// YOUR CODE
});                       
```
```

--------------------------------

### Create QPay Charge with Extra Parameters (C#)

Source: https://www.pingxx.com/docs/server/basic_transaction/charge_refunds/charge.html

This C# example demonstrates creating a charge for the 'qpay' channel, including extra parameters like device information. Ensure the necessary Ping++ SDK components are referenced.

```csharp
var chParams = new Dictionary<string, object>
{
    {"order_no", "123456789"},
    {"amount", 200000},//订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
    {"channel", "qpay"},
    {"currency", "cny"},
    {"subject", "Your Subject"},
    {"body", "Your Body"},
    {"client_ip", "127.0.0.1"},
    {"app", new Dictionary<string, string> {{"id", "app_1Gqj58ynP0mHeX1q"}}},
    {"extra", new Dictionary<string, object> {
      {"device", "ios"}
    }}
};
 
var ch = Charge.Create(chParams);
```

--------------------------------

### Java Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of initiating a recharge request using Java.

```APIDOC
```java
Pingpp.apiKey = "sk_test_ibbTe5jLGCi5rzfH4OqPW9KC";
Map<String, Object> params = new HashMap<>();
params.put("user", "user_test_02"); // 充值目标用户 ID, 必传
params.put("user_fee", 10);     // 用户充值收取的手续费，单位分，不得大于 amount，不可和 balance_bonus[amount] 同时传，默认 0。可选
params.put("description", "Recharge description."); // 描述, 可选
Map<String, Object> charge = new HashMap<>();
charge.put("amount", 100); // 用户实际支付金额，单位分, 必传
charge.put("channel", "yeepay_wap"); // 支付使用的第三方支付渠道, 必传
charge.put("order_no", "2017" + System.currentTimeMillis()); // 商户订单号，适配每个渠道对此参数的要求，必须在商户系统内唯一, 必传
charge.put("client_ip", "127.0.0.1");   // 客户端的 IP，IPv4，默认 127.0.0.1, 可选
charge.put("subject", "Recharge subject"); // 充值标题，该参数最长为 32 个 Unicode 字符, 必传
charge.put("body", "Recharge body"); // 充值描述信息，该参数最长为 128 个 Unicode 字符, 必传
Map<String, Object> extra = new HashMap<>(); // extra: 根据不同渠道传入相应的参数
extra.put("product_category", "1");
extra.put("identity_id", "Your identity_id");
extra.put("identity_type", 1);
extra.put("terminal_type", 1);
extra.put("terminal_id", "Your terminal_id");
extra.put("user_ua", "Your user_ua");
extra.put("result_url", "http://example.com/result");
charge.put("extra", extra);
params.put("charge", charge);
Recharge obj = Recharge.create(params); // 创建 recharge 方法
```
```

--------------------------------

### Create Charge (Go)

Source: https://www.pingxx.com/docs/server/basic_transaction/charge_refunds/charge.html

Initiate a charge request from the server and obtain a Charge object. This example demonstrates setting up charge parameters including extra information like result URL and mobile number.

```APIDOC
## Create Charge (Go)

### Description
Initiates a charge request from the server and obtains a Charge object. This example demonstrates setting up charge parameters including extra information like result URL and mobile number.

### Method
`charge.New`

### Parameters
- `params` (*pingpp.ChargeParams) - Required - Parameters for creating a charge.
  - `Order_no` (string) - Required - The order number.
  - `App` (pingpp.App) - Required - The application object.
    - `Id` (string) - Required - The application ID.
  - `Amount` (int) - Required - The total order amount in cents (e.g., 100 for 1 CNY).
  - `Channel` (string) - Required - The payment channel (e.g., "cmb_pc_qr").
  - `Currency` (string) - Required - The currency code (e.g., "cny").
  - `Client_ip` (string) - Required - The client's IP address.
  - `Subject` (string) - Required - The subject of the charge.
  - `Body` (string) - Required - The body of the charge.
  - `Extra` (map[string]interface{}) - Optional - Additional parameters specific to the payment channel.
    - `result_url` (string) - Optional - The URL to redirect to after payment.
    - `p_no` (string) - Optional - Specific parameter for some channels.
    - `seq` (string) - Optional - Specific parameter for some channels.
    - `m_uid` (string) - Optional - Specific parameter for some channels.
    - `mobile` (string) - Optional - Mobile number for payment.

### Request Example
```go
extra := make(map[string]interface{})
extra["result_url"] = "https://example.com/result"
extra["p_no"] = "2016062901"
extra["seq"] = "2016062901"
extra["m_uid"] = "2016062901"
extra["mobile"] = "18512343456"
params := &pingpp.ChargeParams{
    Order_no:  "123456789",
    App:       pingpp.App{Id: "app_1Gqj58ynP0mHeX1q"},
    Amount:    100,//订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
    Channel:   "cmb_pc_qr",
    Currency:  "cny",
    Client_ip: "127.0.0.1",
    Subject:   "Your Subject",
    Body:      "Your Body",
    Extra:     extra,
}
ch, err := charge.New(params)
```
```

--------------------------------

### PHP Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of initiating a recharge request using PHP.

```APIDOC
## POST /v1/recharges

### Description
Initiates a recharge request from the server to obtain recharge payment credentials.

### Method
POST

### Endpoint
/v1/recharges

### Parameters
#### Request Body
- **user** (string) - Required - The ID of the target user for recharge.
- **charge** (object) - Required - Details of the charge.
  - **amount** (integer) - Required - The actual payment amount by the user, in cents.
  - **channel** (string) - Required - The third-party payment channel used.
  - **order_no** (string) - Required - Merchant order number, unique within the merchant system.
  - **subject** (string) - Required - Recharge title, max 32 Unicode characters.
  - **body** (string) - Required - Recharge description, max 128 Unicode characters.
  - **client_ip** (string) - Optional - Client's IP address (IPv4).
  - **time_expire** (integer) - Optional - Expiration time of the charge.
  - **extra** (object) - Optional - Additional parameters specific to the channel.
    - **product_category** (string) - Optional - Product category.
    - **identity_id** (string) - Optional - Identity ID.
    - **identity_type** (integer) - Optional - Identity type.
    - **terminal_type** (integer) - Optional - Terminal type.
    - **terminal_id** (string) - Optional - Terminal ID.
    - **user_ua** (string) - Optional - User's User-Agent.
    - **result_url** (string) - Optional - URL to receive recharge results.
- **user_fee** (integer) - Optional - Fee charged to the user, in cents. Cannot exceed amount and cannot be provided with `balance_bonus.amount`.
- **balance_bonus** (object) - Optional - Bonus amount for the balance.
  - **amount** (integer) - Required - The bonus amount.
- **from_user** (string) - Optional - The user initiating the recharge.
- **description** (string) - Optional - Description of the recharge.
- **metadata** (object) - Optional - Additional metadata.

### Request Example
```json
{
    "user": "user_test_01",
    "charge": {
        "amount": 100,
        "channel": "yeepay_wap",
        "order_no": "20171234567890",
        "subject": "Your subject",
        "body": "Your body",
        "time_expire": 1514764800,
        "client_ip": "127.0.0.1",
        "extra": {
        	"product_category": "1",
        	"identity_id": "Your identity_id",
        	"identity_type": 1,
        	"terminal_type": 1,
        	"terminal_id": "Your terminal_id",
        	"user_ua": "Your user_ua",
        	"result_url": "http://example.com/result"
		}
    },
    "user_fee": 0,
    "balance_bonus": {
        "amount": 100,
    },
    "from_user": "user_test_02",
    "description": "Your description",
    "metadata": {}
}
```

### Response
#### Success Response (200)
- **id** (string) - Recharge ID.
- **object** (string) - Object type, always "recharge".
- **created** (integer) - Unix timestamp of creation.
- **livemode** (boolean) - Whether the recharge is in live mode.
- **paid** (boolean) - Whether the recharge has been paid.
- **refunded** (boolean) - Whether the recharge has been refunded.
- **app** (string) - App ID.
- **channel** (string) - Payment channel.
- **order_no** (string) - Merchant order number.
- **amount** (integer) - Recharge amount in cents.
- **amount_settle** (integer) - Settled amount in cents.
- **currency** (string) - Currency code.
- **transaction_no** (string) - Transaction number.
- **failure_code** (string) - Failure code if applicable.
- **failure_msg** (string) - Failure message if applicable.
- **metadata** (object) - Metadata.
- **extra** (object) - Extra information.

#### Response Example
```json
{
  "id": "1477895856250",
  "object": "recharge",
  "created": 1477895856,
  "livemode": false,
  "paid": false,
  "refunded": false,
  "app": "app_1551951230155195",
  "channel": "yeepay_wap",
  "order_no": "20171234567890",
  "amount": 100,
  "amount_settle": 100,
  "currency": "cny",
  "transaction_no": null,
  "failure_code": null,
  "failure_msg": null,
  "metadata": {},
  "extra": {
    "product_category": "1",
    "identity_id": "Your identity_id",
    "identity_type": 1,
    "terminal_type": 1,
    "terminal_id": "Your terminal_id",
    "user_ua": "Your user_ua",
    "result_url": "http://example.com/result"
  }
}
```
```

--------------------------------

### Initiate Alipay Payment (Python)

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

This Python example shows how to initiate an Alipay payment using the Ping++ SDK. It passes payment parameters including amount and channel.

```python
pay_params = {
        "charge_amount": 30,
        "channel": 'alipay'
    }
order_pay = pingpp.Order.pay(order.id, **pay_params)

```

--------------------------------

### C# Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of creating a recharge object using the C# SDK.

```APIDOC
## C# SDK Recharge

### Description
This code snippet demonstrates how to create a recharge object using the Ping++ C# SDK.

### Method
Recharge.Create(createParams)

### Parameters
- **createParams** (Dictionary<string, object>) - Required - A dictionary containing recharge parameters.
  - **user** (string) - Required - The ID of the target user for recharge.
  - **user_fee** (int) - Optional - The fee charged to the user, in cents. Cannot exceed `amount` and cannot be passed with `balance_bonus[amount]`.
  - **description** (string) - Optional - A description for the recharge.
  - **metadata** (Dictionary<string, object>) - Optional - Custom data to be stored with the recharge.
  - **balance_bonus** (Dictionary<string, object>) - Optional - Bonus amount to be added to the balance.
    - **amount** (int) - Required - The bonus amount in cents.

### Request Example
```csharp
var createParams = new Dictionary<string, object> 
{
    {"user", "user_test_01"},    //充值目标用户 ID。
    //{"user_fee", 0},            //	用户充值收取的手续费，单位分，不得大于 amount，不可和 balance_bonus[amount] 同时传，默认 0。
    {"description", "Your Recharge description"}, //描述。
    {"metadata", new Dictionary<string,object>{}},
    {"balance_bonus", new Dictionary<string,object>{
```
```

--------------------------------

### Ruby SDK Example for Order Payment

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

Example of how to initiate an order payment using the Ping++ Ruby SDK.

```APIDOC
## Ruby SDK Example for Order Payment

### Description
This Ruby code snippet demonstrates how to use the Ping++ SDK to pay for an order.

### Method
`Pingpp::Order.pay(order_to_pay, params)`

### Parameters
#### Path Parameters
- **order_to_pay** (string) - Required - The ID of the order to pay.

#### Request Body (hash)
- **charge_amount** (integer) - Required - The amount to charge.
- **channel** (string) - Required - The payment channel.

### Request Example
```ruby
o = Pingpp::Order.pay(
  order_to_pay,
  {
    :charge_amount => 1000,
    :channel => 'applepay_upacp'
  }
)
```
```

--------------------------------

### Initiate Alipay Payment (C#)

Source: https://www.pingxx.com/docs/server/account/orders/order_createNpay.html

This C# example demonstrates initiating an Alipay payment. It uses a `Dictionary` to pass payment parameters, including amount, channel, and order number.

```csharp
Order.Pay(or.Id, new Dictionary<string, object> { 
    { "charge_amount",10},
    { "channel", "alipay" },
    {"charge_order_no", "20170808100000001"}
	}
);

```

--------------------------------

### Go Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of creating a recharge object using the Go SDK.

```APIDOC
## Go SDK Recharge

### Description
This code snippet demonstrates how to create a recharge object using the Ping++ Go SDK.

### Method
recharge.New(c.demoAppID, rechargeParams)

### Parameters
- **c.demoAppID** (string) - Required - Your Ping++ application ID.
- **rechargeParams** (*pingpp.RechargeParams) - Required - A pointer to a RechargeParams struct containing recharge details.
  - **User** (string) - Required - The ID of the target user for recharge.
  - **Charge** (pingpp.RechargeCharge) - Required - Details of the charge.
    - **Amount** (int) - Required - The actual payment amount by the user, in cents.
    - **Channel** (string) - Required - The third-party payment channel used.
    - **OrderNo** (string) - Required - Merchant order number, unique within the merchant system.
    - **Subject** (string) - Required - The recharge title, max 32 Unicode characters.
    - **Body** (string) - Required - The recharge description, max 128 Unicode characters.
    - **Extra** (map[string]interface{}) - Optional - Additional parameters specific to the channel.
      - **device** (string) - Example parameter for extra data.
  - **BalanceBonus** (pingpp.RechargeBonus) - Optional - Bonus amount to be added to the balance.
    - **Amount** (int) - Required - The bonus amount in cents.
  - **Description** (string) - Optional - A description for the recharge.

### Request Example
```go
	extra := make(map[string]interface{})
    extra["device"] = "ios"
	rechargeParams := &pingpp.RechargeParams{
		User: "1477895856250",
		Charge: pingpp.RechargeCharge{
			Amount:  10,
			Channel: "ccb_qr",
			OrderNo: fmt.Sprintf("%d", orderno),
			Subject: "Go SDK Subject",
			Body:    "Go SDK Body",
			Extra:     extra,
		},
		BalanceBonus: pingpp.RechargeBonus{
			Amount: 1,
		},
		Description: "Go SDK Description",
	}
	return recharge.New(c.demoAppID, rechargeParams)
```
```

--------------------------------

### Ruby Recharge Example

Source: https://www.pingxx.com/docs/server/account/balances/recharge.html

Example of creating a recharge object using the Ruby SDK.

```APIDOC
## Ruby SDK Recharge

### Description
This code snippet demonstrates how to create a recharge object using the Ping++ Ruby SDK.

### Method
Pingpp::Recharge.create(params, { app: get_app_id })

### Parameters
- **params** (Hash) - Required - A hash containing recharge parameters.
  - **user** (String) - Required - The ID of the target user for recharge.
  - **charge** (Hash) - Required - Details of the charge.
    - **order_no** (String) - Required - Merchant order number, unique within the merchant system.
    - **channel** (String) - Required - The third-party payment channel used.
    - **client_ip** (String) - Optional - The client's IP address (IPv4).
    - **amount** (Integer) - Required - The total amount of the recharge in cents.
    - **body** (String) - Required - The recharge description, max 128 Unicode characters.
    - **subject** (String) - Required - The recharge title, max 32 Unicode characters.
    - **extra** (Hash) - Optional - Additional parameters specific to the channel.
      - **pos_id** (String) - Required for some channels - Point of Sale ID.
      - **remark** (String) - Optional - Remark for the transaction.
      - **return_type** (Integer) - Optional - Return type indicator.
  - **description** (String) - Optional - A description for the recharge.
- **options** (Hash) - Optional - Options hash.
  - **app** (String) - Required - Your Ping++ application ID.

### Request Example
```ruby
	params = {
		:user => get_user_id,
		:charge => {
			:order_no => order_no,
			:channel => "ccb_qr", # 支付渠道
			:client_ip => "127.0.0.1", # 发起支付请求客户端的 IP 地址，格式为 IPV4，如: 127.0.0.1
			:amount => 100, # 订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100）
			:body => "Your Body",
			:subject => "You Subject",
			:extra => {
				: pos_id => '025547632',
       		: remark => 'test',
 	       	: return_type => 1
		}
		},
		:description => "充值描述"
	}
 
	o = Pingpp::Recharge.create(
		params,
		{ :app => get_app_id } # App 信息
	)
```
```
Tokens:
Raw