LianLian Global OpenAPI

https://docs.lianlianglobal.com.cn/api_docs
Admin
LianLian Global OpenAPI offers a comprehensive suite of financial services APIs for global...
Tokens:52,192
Snippets:165
Trust Score:3.2
Update:11 months ago
Show doc for...
Tokens:
Raw
### GET /llg-balances

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves the available balance for each currency associated with an account. Requires AcessToken and Signature.

```APIDOC
## GET /llg-balances

### Description
Retrieves the available balance for each currency associated with an account. Requires AcessToken and Signature.

### Method
GET

### Endpoint
/llg-balances

### Parameters
#### Query Parameters
- **account_id** (string) - Required - The account ID for which to retrieve the balance.
- **currency** (string) - Optional - The currency for which to retrieve the balance.

### Request Example
```bash
curl -i -X GET \
-H "Authorization: Basic <Token>" \
-H "LLPAY-Signature: t=epoch&v=<Signature>" \
https://test-global-api.lianlianpay-inc.com/gateway/v2/llgbalances?account_id=some_account_id&currency=USD
```

### Response
#### Success Response (200)
- **account_id** (string) - Description
- **currency** (string) - Description
- **available_amount** (string) - Description

#### Response Example
```json
[
  {
    "account_id": "string",
    "currency": "string",
    "available_amount": "string"
  }
]
```
```

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

### Lock FX Response Sample (200 OK)

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Example of a successful response (HTTP 200 OK) when locking an FX rate. It provides the rate ID, the exchange rate, currency details, and the validity period of the locked rate.

```json
{
  "rate_id": "string",
  "rate": "string",
  "base_currency": "string",
  "sell_currency": "string",
  "buy_currency": "string",
  "validity": "T_0",
  "valid_strarting_after": "string",
  "valid_ending_before": "string"
}
```

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

### GET /llg-contacts/network/list

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves a list of all Network accounts. Supports pagination and keyword search.

```APIDOC
## GET /llg-contacts/network/list

### Description
Queries all Network accounts. The data list is ordered by create_time in descending order.

### Method
GET

### Endpoint
/llg-contacts/network/list

### Query Parameters
- **page** (integer) - Required - Page number.
- **page_size** (integer) - Required - Number of items per page. Maximum 100.
- **keyword** (string) - Optional - Keyword for filtering.

### Request Example
```json
{
  "page": 0,
  "page_size": 0,
  "keyword": "string"
}
```

### Response
#### Success Response (200)
- **page_list** (array) - List of network accounts.
  - **id** (string) - Account ID.
  - **merchant_client_id** (string) - Merchant client ID.
  - **entity_type** (string) - Entity type (e.g., "CORPORATE").
  - **base_info** (object) - Basic information about the account.
    - **country_code** (string) - Country code.
    - **corporate_name** (string) - Corporate name.
    - **email** (string) - Email address.
    - **first_name** (string) - First name.
    - **middle_name** (string) - Middle name.
    - **last_name** (string) - Last name.
    - **nickname** (string) - Nickname.
  - **status** (string) - Account status (e.g., "REJECTED").
  - **additional_info** (array) - Additional information.
    - **name** (string) - Information name.
    - **value** (string) - Information value.
  - **user_kyc_name** (string) - User KYC name.
  - **user_kyc_status** (string) - User KYC status (e.g., "ACCEPTED").
- **total_count** (integer) - Total number of accounts found.

#### Response Example (200)
```json
{
  "page_list": [
    {
      "id": "string",
      "merchant_client_id": "string",
      "entity_type": "CORPORATE",
      "base_info": {
        "country_code": "string",
        "corporate_name": "string",
        "email": "string",
        "first_name": "string",
        "middle_name": "string",
        "last_name": "string",
        "nickname": "string"
      },
      "status": "REJECTED",
      "additional_info": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "user_kyc_name": "string",
      "user_kyc_status": "ACCEPTED"
    }
  ],
  "total_count": 0
}
```

#### Error Response (400)
Bad request.

#### Error Response (500)
Internal Server Error.
```

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

### Query Account Balance cURL Request

Source: https://docs.lianlianglobal.com.cn/api_docs/index

This cURL command demonstrates how to request the account balance. It includes the necessary HTTP GET method, authorization headers with a token and signature, and the API endpoint URL. This is a common way to interact with the balance API.

```curl
curl -i -X GET \
-H "Authorization: Basic <Token>" \
-H "LLPAY-Signature: t=epoch&v=<Signature>" \
https://test-global-api.lianlianpay-inc.com/gateway/v2/llgbalances
```

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

### POST /acquire-request-payment/url

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Initiates a payment request, generating a payment link for the payer.

```APIDOC
## POST /acquire-request-payment/url

### Description
Initiates a payment, creating a new payment and providing a link for the payer to complete the transaction.

### Method
POST

### Endpoint
/acquire-request-payment/url

### Parameters
#### Request Body
- **request_id** (string) - Required - Unique request ID.
- **business_order_id** (string) - Optional - Business order ID.
- **amount** (string) - Required - Amount in Yuan.
- **currency** (string) - Required - Currency.
- **payment_method** (string) - Required - Payment method, value: "Pay with LianLian".
- **customer** (object) - Required - Merchant information (CustomerInfo).
  - **customer_id** (string) - Customer ID.
  - **customer_name** (string) - Customer name.
  - **customer_country** (string) - Customer country.
  - **customer_type** (string) - Customer type.
- **orders** (Array of objects) - Required - Order details (OrderInfo).
  - **order_id** (string) - Order ID.
  - **order_amount** (string) - Order amount.
  - **order_currency** (string) - Order currency.
  - **order_description** (string) - Order description.
  - **purchase_time** (long) - Purchase timestamp.
  - **shipping** (object) - Shipping details.
    - **carrier** (string) - Carrier name.
  - **product_id** (string) - Product ID.
  - **product_name** (string) - Product name.
  - **product_count** (string) - Product count.
  - **goods_category** (string) - Goods category.
- **expiry_time** (long) - Required - Expiry timestamp.
- **additional_info** (object) - Optional - Extended information (Map).
- **return_url** (string) - Required - Redirect URL.

### Request Example
```json
{
  "request_id": "string",
  "business_order_id": "string",
  "amount": "string",
  "currency": "string",
  "payment_method": "Pay with LianLian",
  "customer": {
    "customer_id": "string",
    "customer_name": "string",
    "customer_country": "string",
    "customer_type": "string"
  },
  "orders": [
    {
      "order_id": "string",
      "order_amount": "string",
      "order_currency": "string",
      "order_description": "string",
      "purchase_time": 0,
      "shipping": {
        "carrier": "string"
      },
      "product_id": "string",
      "product_name": "string",
      "product_count": "string",
      "goods_category": "string"
    }
  ],
  "expiry_time": null,
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  },
  "return_url": "string"
}
```

### Response
#### Success Response (200)
(Response details for payment initiation are not explicitly provided in the input, but a 200 OK indicates success.)

#### Response Example
(Response example for payment initiation is not provided in the input.)
```

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

### GET /llg-receiving/accounts

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves a list of all receiving accounts associated with the user. This endpoint is useful for getting an overview of available accounts.

```APIDOC
## GET /llg-receiving/accounts

### Description
Retrieves a list of all receiving accounts associated with the user. This endpoint is useful for getting an overview of available accounts.

### Method
GET

### Endpoint
/llg-receiving/accounts

### Parameters
#### Query Parameters
- **page** (integer) - Required - The page number for pagination.
- **page_size** (integer) - Required - The number of items per page (max 100).
- **keyword** (string) - Optional - A keyword to filter the accounts.

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the account.
- **nickname** (string) - A user-defined nickname for the account.
- **bank_info** (object) - Details about the bank where the account is held.
  - **aba** (string) - ABA routing number.
  - **account_type** (string) - The type of bank account (e.g., Checking).
  - **account_holders_name** (string) - The name of the account holder.
  - **swift_code** (string) - SWIFT code for international transfers.
  - **bank_account_number** (string) - The bank account number.
  - **bank_name** (string) - The name of the bank.
  - **bank_country_region** (string) - The country/region code of the bank.
  - **bank_country_region_name** (string) - The name of the bank's country/region.
  - **bank_address** (string) - The address of the bank.
  - **routing_number** (string) - Routing number for domestic transfers.
  - **bank_id** (string) - Unique identifier for the bank.
  - **wireaba** (string) - Wire transfer ABA number.
  - **create_time** (null) - Timestamp of account creation (currently null).
  - **channel_code** (string) - Code for the transaction channel.
- **additional_info** (object) - Additional information related to the account.
  - **phone** (string) - Associated phone number.
  - **remark** (string) - Any remarks or notes about the account.
  - **business_order_id** (string) - Business order identifier.
- **status** (string) - The current status of the account (e.g., APPLYING).
- **create_time** (null) - Timestamp of record creation (currently null).

#### Response Example
```json
[
  {
    "id": "string",
    "nickname": "string",
    "bank_info": {
      "aba": "Checking",
      "account_type": "Checking",
      "account_holders_name": "string",
      "swift_code": "string",
      "bank_account_number": "string",
      "bank_name": "string",
      "bank_country_region": "string",
      "bank_country_region_name": "string",
      "bank_address": "string",
      "routing_number": "string",
      "bank_id": "string",
      "wireaba": "string",
      "create_time": null,
      "channel_code": "string"
    },
    "additional_info": {
      "phone": "xxxxx",
      "remark": "xxxxxxx",
      "business_order_id": "string"
    },
    "status": "APPLYING",
    "create_time": null
  }
]
```
```

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

### Initiate Refund API Request Sample (JSON)

Source: https://docs.lianlianglobal.com.cn/api_docs/index

This JSON payload demonstrates the structure for initiating a refund. It includes essential details such as unique request and payment IDs, currency, amount, and optional reference and additional information.

```json
{
  "request_id": "string",
  "business_order_id": "string",
  "request_payment_id": "string",
  "send_currency": "string",
  "send_amount": "string",
  "reference": "string",
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  }
}
```

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

### GET /llg-accounts/account - Get Account Information

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves detailed information about a specific LianLian Global account. This endpoint is useful for checking the status and details of an account after it has been created.

```APIDOC
## Query Account Information

Retrieves the details of an account.

### Method
GET

### Endpoint
`/gateway/v2/llg-accounts/account`

### Authorizations
AccessToken, Signature

### Responses

#### Success Response (200)
OK
- **account_id** (string) - The unique identifier for the account.
- **email** (string) - The email address of the account.
- **name** (string) - The name associated with the account.
- **country_code** (string) - The country code of the account.
- **entity_type** (string) - The type of the account (CORPORATE/INDIVIDUAL).
- **phone_district** (string) - The phone number's district code.
- **phone** (string) - The phone number.
- **status** (string) - The current status of the account (e.g., "INIT").
- **kyc_status** (string) - The current KYC status of the account (e.g., "UNDER_REVIEW").
- **kyc_comments** (array) - A list of KYC-related comments.
    - **kyc_comment** (string) - A specific KYC comment.
    - **kyc_comment_code** (string) - A code associated with the KYC comment.

#### Error Response (400)
Bad Request

#### Error Response (500)
Internal Server Error

### Response Example (200 OK)
```json
{
  "account_id": "string",
  "email": "string",
  "name": "string",
  "country_code": "US",
  "entity_type": "CORPORATE",
  "phone_district": "CN",
  "phone": "string",
  "status": "INIT",
  "kyc_status": "UNDER_REVIEW",
  "kyc_comments": [
    {
      "kyc_comment": "string",
      "kyc_comment_code": "string"
    }
  ]
}
```
```

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

### GET /llg-contacts/network/{id}

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves a single Network payee by its ID.

```APIDOC
## GET /llg-contacts/network/{id}

### Description
Retrieves a single Network payee by its ID.

### Method
GET

### Endpoint
/llg-contacts/network/{id}

### Path Parameters
- **id** (string) - Required - The ID of the network payee.

### Response
#### Success Response (200)
- **id** (string) - Payee ID.
- **merchant_client_id** (string) - Merchant client ID.
- **entity_type** (string) - Entity type (e.g., "CORPORATE").
- **base_info** (object) - Basic information about the payee.
  - **country_code** (string) - Country code.
  - **corporate_name** (string) - Corporate name.
  - **email** (string) - Email address.
  - **first_name** (string) - First name.
  - **middle_name** (string) - Middle name.
  - **last_name** (string) - Last name.
  - **nickname** (string) - Nickname.
- **status** (string) - Payee status (e.g., "REJECTED").
- **additional_info** (array) - Additional information.
  - **name** (string) - Information name.
  - **value** (string) - Information value.
- **user_kyc_name** (string) - User KYC name.
- **user_kyc_status** (string) - User KYC status (e.g., "ACCEPTED").

#### Response Example (200)
```json
{
  "id": "string",
  "merchant_client_id": "string",
  "entity_type": "CORPORATE",
  "base_info": {
    "country_code": "string",
    "corporate_name": "string",
    "email": "string",
    "first_name": "string",
    "middle_name": "string",
    "last_name": "string",
    "nickname": "string"
  },
  "status": "REJECTED",
  "additional_info": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "user_kyc_name": "string",
  "user_kyc_status": "ACCEPTED"
}
```

#### Error Response (400)
Bad request.

#### Error Response (404)
Data Not Found.

#### Error Response (500)
Internal Server Error.
```

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

### Create Payment Request Sample (JSON)

Source: https://docs.lianlianglobal.com.cn/api_docs/index

This JSON payload illustrates how to create a payment request. It includes comprehensive details about the transaction, customer, order items, and return URL, essential for initiating a payment flow.

```json
{
  "request_id": "string",
  "business_order_id": "string",
  "amount": "string",
  "currency": "string",
  "payment_method": "Pay with LianLian",
  "customer": {
    "customer_id": "string",
    "customer_name": "string",
    "customer_country": "string",
    "customer_type": "string"
  },
  "orders": [
    {
      "order_id": "string",
      "order_amount": "string",
      "order_currency": "string",
      "order_description": "string",
      "purchase_time": 0,
      "shipping": {
        "carrier": "string"
      },
      "product_id": "string",
      "product_name": "string",
      "product_count": "string",
      "goods_category": "string"
    }
  ],
  "expiry_time": null,
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  },
  "return_url": "string"
}
```

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

### GET /gateway/v2/cards/{card_id}

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves the detailed information for a specific virtual card.

```APIDOC
## GET /gateway/v2/cards/{card_id}

### Description
Retrieves the detailed information for a specific virtual card.

### Method
GET

### Endpoint
/gateway/v2/cards/{card_id}

### Parameters
#### Path Parameters
- **card_id** (string) - Required - The ID of the card to retrieve.

### Response
(Assuming response structure is similar to the 'get/cards/list' success response for a single card)
#### Success Response (200)
- **card_id** (string) - The unique identifier for the card.
- **card_name** (string) - The name of the card.
- **contact_email** (string) - The contact email for the card.
- **currency** (string) - The settlement currency.
- **status** (string) - The current status of the card.
- **card_number** (string) - The virtual card number.
- **per_transaction_limit** (string) - Per-transaction limit.
- **daily_limit** (string) - Daily transaction limit.
- **monthly_limit** (string) - Monthly transaction limit.
- **accumulated_spend_limit** (string) - Accumulated spend limit.
- **create_time** (null) - The creation timestamp (currently null).

#### Response Example
```json
{
  "card_id": "string",
  "card_name": "string",
  "contact_email": "string",
  "currency": "string",
  "status": "APPLYING",
  "card_number": "string",
  "per_transaction_limit": "string",
  "daily_limit": "string",
  "monthly_limit": "string",
  "accumulated_spend_limit": "string",
  "create_time": null
}
```
```

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

### POST /llg-accounts/account - Create Account

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Creates a new LianLian Global account for users, merchants, or partners. This endpoint allows for the creation of accounts with essential details and sets the stage for subsequent KYC verification.

```APIDOC
## Create Account

Creates a new LianLian Global account for your users, merchants, subsidiaries, or business partners. You can add more information to the account later. After providing all necessary information, you can submit the account for KYC using the 'Submit Account KYC' endpoint. Accounts created via 'Create Account' can only be accessed through the third-party authorization mode API and cannot operate the portal.

### Method
POST

### Endpoint
`/gateway/v2/llg-accounts/account`

### Authorizations
BasicAccessToken, Signature

### Request Body

#### Parameters (application/json)

*   **email** (string) - Required - Max 64 characters. The unique identifier for the account's email address. Must follow email format.
*   **country_code** (string) - Required - ISO 3166-2 two-letter country code. Specifies the country/region of the account.
*   **entity_type** (string) - Required - Enum: "CORPORATE", "INDIVIDUAL". The type of account to be created (Corporate or Individual).
*   **phone_district** (string) - Optional - Specifies the country/region code for the phone number. Examples: "CN", "US", "SG".
*   **phone** (string) - Optional - Max 11 characters. The phone number of the account. Must contain only digits.
*   **identifier** (string) - Required - Max 64 characters. A unique identifier for the account on the platform.
*   **agreed_to_terms_and_conditions** (boolean) - Required - Indicates whether the terms and conditions have been agreed to.
*   **agreement_id** (string) - Optional - Max 128 characters. The ID of the agreement document, if applicable.

### Responses

#### Success Response (200)
OK
- **account_id** (string) - The unique identifier for the created account.
- **email** (string) - The email address of the account.
- **name** (string) - The name associated with the account.
- **country_code** (string) - The country code of the account.
- **entity_type** (string) - The type of the account (CORPORATE/INDIVIDUAL).
- **phone_district** (string) - The phone number's district code.
- **phone** (string) - The phone number.
- **status** (string) - The current status of the account (e.g., "INIT").
- **kyc_status** (string) - The current KYC status of the account (e.g., "UNDER_REVIEW").
- **kyc_comments** (array) - A list of KYC-related comments.
    - **kyc_comment** (string) - A specific KYC comment.
    - **kyc_comment_code** (string) - A code associated with the KYC comment.

#### Error Response (400)
Bad Request

#### Error Response (500)
Internal Server Error

### Request Example
```json
{
  "email": "string",
  "country_code": "US",
  "entity_type": "CORPORATE",
  "phone_district": "CN",
  "phone": "string",
  "identifier": "string",
  "agreed_to_terms_and_conditions": true,
  "agreement_id": "string"
}
```

### Response Example (200 OK)
```json
{
  "account_id": "string",
  "email": "string",
  "name": "string",
  "country_code": "US",
  "entity_type": "CORPORATE",
  "phone_district": "CN",
  "phone": "string",
  "status": "INIT",
  "kyc_status": "UNDER_REVIEW",
  "kyc_comments": [
    {
      "kyc_comment": "string",
      "kyc_comment_code": "string"
    }
  ]
}
```
```

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

### GET /gateway/v2/cards/list

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves a list of all virtual cards issued under the account, with optional filtering.

```APIDOC
## GET /gateway/v2/cards/list

### Description
Retrieves a list of all virtual cards issued under the account, with optional filtering.

### Method
GET

### Endpoint
https://api.lianlianglobal.com.cn/gateway/v2/cards/list

### Parameters
#### Request Body (Note: This endpoint uses query parameters, not a request body for filtering in typical RESTful design, but the input suggests a body schema. Assuming query parameters for standard GET requests.)

#### Query Parameters
- **page** (integer) - Required - The page number for pagination.
- **page_size** (integer) - Required - The number of items per page (max 100).
- **search** (string) - Optional - Search by card name or last four digits of the card number.
- **status** (string) - Optional - Filter by card status (Enum: "APPLYING", "VALID", "CANCEL", "ABNORMAL", "EXPIRED").

### Request Example (as query parameters)
GET /gateway/v2/cards/list?page=0&page_size=100&status=VALID

### Response
#### Success Response (200)
- **page_list** (array) - A list of card objects.
  - **card_id** (string) - The unique identifier for the card.
  - **card_name** (string) - The name of the card.
  - **contact_email** (string) - The contact email for the card.
  - **currency** (string) - The settlement currency.
  - **status** (string) - The current status of the card.
  - **card_number** (string) - The virtual card number.
  - **per_transaction_limit** (string) - Per-transaction limit.
  - **daily_limit** (string) - Daily transaction limit.
  - **monthly_limit** (string) - Monthly transaction limit.
  - **accumulated_spend_limit** (string) - Accumulated spend limit.
  - **create_time** (null) - The creation timestamp (currently null).
- **total_count** (integer) - The total number of cards matching the criteria.

#### Response Example
```json
{
  "page_list": [
    {
      "card_id": "string",
      "card_name": "string",
      "contact_email": "string",
      "currency": "string",
      "status": "APPLYING",
      "card_number": "string",
      "per_transaction_limit": "string",
      "daily_limit": "string",
      "monthly_limit": "string",
      "accumulated_spend_limit": "string",
      "create_time": null
    }
  ],
  "total_count": 0
}
```
```

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

### POST /acquire-payment/refund

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Initiate a refund for a payment. This endpoint supports partial and full refunds, returning funds to the original payer.

```APIDOC
## POST /acquire-payment/refund

### Description
Initiate a refund for a payment. This endpoint supports partial and full refunds, returning funds to the original payer.

### Method
POST

### Endpoint
`/gateway/v2/acquire-payment/refund`

### Parameters
#### Request Body
- **request_id** (string) - Required - Unique request ID.
- **business_order_id** (string) - Required - The merchant's order ID.
- **request_payment_id** (string) - Required - The unique ID of the payment request to be refunded.
- **send_currency** (string) - Required - The currency to be credited to the payer (ISO 4217 format).
- **send_amount** (string) - Required - The amount to be refunded.
- **reference** (string) - Optional - <= 128 characters. A reference message visible to the recipient.
- **additional_info** (object) - Optional - Extended information.
  - **phone** (string) - Customer's phone number.
  - **remark** (string) - A remark for the transaction.
  - **business_order_id** (string) - The merchant's order ID.

### Request Example
```json
{
  "request_id": "string",
  "business_order_id": "string",
  "request_payment_id": "string",
  "send_currency": "string",
  "send_amount": "string",
  "reference": "string",
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  }
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the refund transaction.
- **request_id** (string) - The unique ID used to initiate the original payment request.
- **business_order_id** (string) - The merchant's order ID.
- **request_payment_id** (string) - The unique ID of the original payment request.
- **pay_currency** (string) - The currency of the original payment.
- **pay_amount** (string) - The amount of the original payment.
- **send_currency** (string) - The currency being refunded.
- **send_amount** (string) - The amount being refunded.
- **fee** (object) - Details of any fees associated with the refund.
  - **currency** (string) - The currency of the fee.
  - **amount** (string) - The amount of the fee.
- **failure_code** (string) - The error code if the refund failed.
- **failure_reason** (string) - The reason for the refund failure.
- **status** (string) - The current status of the refund (e.g., PROCESSING, SUCCEEDED, FAILED).
- **reference** (string) - The reference message provided for the refund.
- **additional_info** (object) - Additional information related to the refund.
  - **phone** (string) - Customer's phone number.
  - **remark** (string) - A remark for the transaction.
  - **business_order_id** (string) - The merchant's order ID.
- **create_time** (null) - The timestamp when the refund was initiated.

#### Response Example
```json
{
  "id": "string",
  "request_id": "string",
  "business_order_id": "string",
  "request_payment_id": "string",
  "pay_currency": "string",
  "pay_amount": "string",
  "send_currency": "string",
  "send_amount": "string",
  "fee": {
    "currency": "string",
    "amount": "string"
  },
  "failure_code": "string",
  "failure_reason": "string",
  "status": "PROCESSING",
  "reference": "string",
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  },
  "create_time": null
}
```
```

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

### GET /llg-receipt/refund/{request_id}

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Queries the details of a refund request using its request ID.

```APIDOC
## GET /llg-receipt/refund/{request_id}

### Description
Queries the details of a refund request using the provided request ID.

### Method
GET

### Endpoint
/llg-receipt/refund/{request_id}

### Parameters
#### Path Parameters
- **request_id** (string) - Required - Request ID.

### Response
#### Success Response (200)
- **id** (string) - Response ID.
- **request_id** (string) - Request ID.
- **business_order_id** (string) - Business order ID.
- **request_payment_id** (string) - Request payment ID.
- **pay_currency** (string) - Payment currency.
- **pay_amount** (string) - Payment amount.
- **send_currency** (string) - Arrival currency.
- **send_amount** (string) - Arrival amount.
- **fee** (object) - Fee details.
  - **currency** (string) - Fee currency.
  - **amount** (string) - Fee amount.
- **failure_code** (string) - Failure code if applicable.
- **failure_reason** (string) - Failure reason if applicable.
- **status** (string) - Refund status (e.g., PROCESSING).
- **reference** (string) - Reference.
- **additional_info** (object) - Extended information.
- **create_time** (null) - Creation timestamp.

#### Response Example
```json
{
  "id": "string",
  "request_id": "string",
  "business_order_id": "string",
  "request_payment_id": "string",
  "pay_currency": "string",
  "pay_amount": "string",
  "send_currency": "string",
  "send_amount": "string",
  "fee": {
    "currency": "string",
    "amount": "string"
  },
  "failure_code": "string",
  "failure_reason": "string",
  "status": "PROCESSING",
  "reference": "string",
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  },
  "create_time": null
}
```
```

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

### Query Settlement Summary

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Fetches a summary of settlement information based on specified pagination and time range. It requires an access token and signature, and returns a list of settlement summaries or error information.

```HTTP
POST /gateway/v2/acquire-settlement-report
Authorization: Bearer <YourAccessToken>
Signature: <YourSignature>
Content-Type: application/json

{
  "page": 0,
  "page_size": 0,
  "start_time": null,
  "end_time": null
}
```

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

### Activate Virtual Card Service

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Enables the virtual card service by agreeing to the terms and conditions and specifying payment methods. This API requires basic access token and signature for authorization and confirms service activation.

```HTTP
POST /gateway/v2/service/agreement
Authorization: Basic <YourBasicAccessToken>
Signature: <YourSignature>
Content-Type: application/json

{
  "agreed_to_terms_and_conditions": true,
  "agreement_id": "string",
  "payment_method": [
    "Advertising / Affiliate marketing"
  ]
}
```

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

### GET /gateway/v2/llg-withdraw/{request_id}

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Queries the details of a withdrawal request using its request ID.

```APIDOC
## GET /gateway/v2/llg-withdraw/{request_id}

### Description
Queries the details of a withdrawal request using its request ID.

### Method
GET

### Endpoint
https://api.lianlianglobal.com.cn/gateway/v2/llg-withdraw/{request_id}

### Parameters
#### Path Parameters
- **request_id** (string) - Required - The request ID, unique idempotency key, max length 64 characters.

### Response
#### Success Response (200)
- **request_id** (string) - The request ID.
- **business_order_id** (string) - The business order ID.
- **beneficiary_id** (string) - The beneficiary ID.
- **conversion** (object) - Conversion details if applicable.
  - **sell_currency** (string) - Currency being sold.
  - **sell_amount** (string) - Amount being sold.
  - **rate_id** (string) - Rate ID.
  - **rate** (string) - Exchange rate.
  - **base_currency** (string) - Base currency for the rate.
  - **buy_currency** (string) - Currency being bought.
  - **buy_amount** (string) - Amount being bought.
  - **expire_time** (null) - Expiration time of the rate.
  - **create_time** (null) - Creation time of the rate.
- **withdraw_currency** (string) - The currency withdrawn.
- **withdraw_amount** (string) - The amount withdrawn.
- **send_currency** (string) - The currency sent.
- **send_amount** (string) - The amount sent.
- **fee** (object) - Transaction fee details.
  - **currency** (string) - Fee currency.
  - **amount** (string) - Fee amount.
- **refund_currency** (string) - Refund currency, if any.
- **refund_amount** (string) - Refund amount, if any.
- **failure_code** (string) - Failure code, if the transaction failed.
- **failure_reason** (string) - Reason for failure, if applicable.
- **status** (string) - Current status of the withdrawal (e.g., PROCESSING).
- **reference** (string) - Reference text.
- **additional_info** (Array of objects) - Additional information provided.
  - **name** (string) - Information name.
  - **value** (string) - Information value.
- **create_time** (null) - Creation timestamp of the withdrawal request.

#### Response Example (200)
```json
{
  "request_id": "string",
  "business_order_id": "string",
  "beneficiary_id": "string",
  "conversion": {
    "sell_currency": "string",
    "sell_amount": "string",
    "rate_id": "string",
    "rate": "string",
    "base_currency": "string",
    "buy_currency": "string",
    "buy_amount": "string",
    "expire_time": null,
    "create_time": null
  },
  "withdraw_currency": "string",
  "withdraw_amount": "string",
  "send_currency": "string",
  "send_amount": "string",
  "fee": {
    "currency": "string",
    "amount": "string"
  },
  "refund_currency": "string",
  "refund_amount": "string",
  "failure_code": "string",
  "failure_reason": "string",
  "status": "PROCESSING",
  "reference": "string",
  "additional_info": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "create_time": null
}
```
```

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

### POST /api/v1/files/download

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Downloads a file using its ID. Requires both AccessToken and Signature for authorization.

```APIDOC
## POST /api/v1/files/download

### Description
Downloads a file using its ID. Requires both AccessToken and Signature for authorization.

### Method
POST

### Endpoint
/api/v1/files/download

### Parameters
#### Request Body
- **id** (string) - Required - File ID.

### Response
#### Success Response (200)
- Description: OK

#### Error Response (400)
- Description: Error

#### Error Response (404)
- Description: Data Not Found

#### Error Response (500)
- Description: Internal Server Error

### Request Example
```json
{
  "id": "string"
}
```

### Response Example (400)
```json
null
```
```

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

### GET /llg-payouts/{request_id}

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves the details of a payout transaction using the request ID.

```APIDOC
## GET /llg-payouts/{request_id}

### Description
Retrieves the details of a payout transaction using the request ID.

### Method
GET

### Endpoint
/llg-payouts/{request_id}

#### Path Parameters
- **request_id** (string) - Required - The unique identifier for the payout request.

### Response
#### Success Response (200)
OK
```json
{
  "id": "string",
  "request_id": "string",
  "business_order_id": "string",
  "payee_id": "string",
  "payee_bank_info": {
    "bank_country_code": "string",
    "holder_name": "string",
    "holder_type": "string",
    "account_currency": "string",
    "account_number": "string",
    "bank_name": "string",
    "bank_address": "string",
    "clearing_code": "SWIFT",
    "swift_code": "string",
    "iban": "string",
    "bank_code": "string",
    "routing_number": "string",
    "sort_code": "string",
    "transit_number": "string",
    "institution_number": "string"
  },
  "conversion": {
    "sell_currency": "string",
    "sell_amount": "string",
    "rate_id": "string",
    "rate": "string",
    "base_currency": "string",
    "buy_currency": "string",
    "buy_amount": "string",
    "expire_time": null,
    "create_time": null
  },
  "rate_id": "string",
  "pay_currency": "string",
  "send_currency": "string",
  "send_amount": "string",
  "pay_amount": "string",
  "fee": {
    "currency": "string",
    "amount": "string"
  },
  "purpose": "string",
  "refund_currency": "string",
  "refund_amount": "string",
  "failure_code": "string",
  "failure_reason": "string",
  "status": "PROCESSING",
  "file_ids": [],
  "reference": "string",
  "additional_info": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "create_time": null
}
```

#### Error Responses
- **400**: Bad Request
- **404**: Data Not Found
- **500**: Internal Server Error
```

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

### GET /llg-contacts/network/merchant-client-id/{merchant_client_id}

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Retrieves a Network payee by the platform merchant client ID.

```APIDOC
## GET /llg-contacts/network/merchant-client-id/{merchant_client_id}

### Description
Retrieves a Network payee based on the platform merchant client ID.

### Method
GET

### Endpoint
/llg-contacts/network/merchant-client-id/{merchant_client_id}

### Path Parameters
- **merchant_client_id** (string) - Required - The platform merchant client ID.

### Response
#### Success Response (200)
- **id** (string) - Payee ID.
- **merchant_client_id** (string) - Merchant client ID.
- **entity_type** (string) - Entity type (e.g., "CORPORATE").
- **base_info** (object) - Basic information about the payee.
  - **country_code** (string) - Country code.
  - **corporate_name** (string) - Corporate name.
  - **email** (string) - Email address.
  - **first_name** (string) - First name.
  - **middle_name** (string) - Middle name.
  - **last_name** (string) - Last name.
  - **nickname** (string) - Nickname.
- **status** (string) - Payee status (e.g., "REJECTED").
- **additional_info** (array) - Additional information.
  - **name** (string) - Information name.
  - **value** (string) - Information value.
- **user_kyc_name** (string) - User KYC name.
- **user_kyc_status** (string) - User KYC status (e.g., "ACCEPTED").

#### Response Example (200)
```json
{
  "id": "string",
  "merchant_client_id": "string",
  "entity_type": "CORPORATE",
  "base_info": {
    "country_code": "string",
    "corporate_name": "string",
    "email": "string",
    "first_name": "string",
    "middle_name": "string",
    "last_name": "string",
    "nickname": "string"
  },
  "status": "REJECTED",
  "additional_info": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "user_kyc_name": "string",
  "user_kyc_status": "ACCEPTED"
}
```

#### Error Response (400)
Bad request.

#### Error Response (404)
Data Not Found.

#### Error Response (500)
Internal Server Error.
```

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

### Response Sample: Single Receiving Account (JSON)

Source: https://docs.lianlianglobal.com.cn/api_docs/index

This is a sample JSON response for a single receiving account. It includes details such as the account ID, nickname, bank information, and additional contact or business-related information. The status indicates the current state of the account.

```json
{
  "id": "string",
  "nickname": "string",
  "bank_info": {
    "aba": "Checking",
    "account_type": "Checking",
    "account_holders_name": "string",
    "swift_code": "string",
    "bank_account_number": "string",
    "bank_name": "string",
    "bank_country_region": "string",
    "bank_country_region_name": "string",
    "bank_address": "string",
    "routing_number": "string",
    "bank_id": "string",
    "wireaba": "string",
    "create_time": null,
    "channel_code": "string"
  },
  "additional_info": {
    "phone": "xxxxx",
    "remark": "xxxxxxx",
    "business_order_id": "string"
  },
  "status": "APPLYING",
  "create_time": null
}
```

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

### Create Payer API Endpoint

Source: https://docs.lianlianglobal.com.cn/api_docs/index

This documentation outlines the POST endpoint for creating a new payer. It requires a JSON request body containing payer details and authentication via AccessToken and Signature.

```http
POST /llg-contacts/payer
```

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

### Download Settlement Report

Source: https://docs.lianlianglobal.com.cn/api_docs/index

Initiates the download of a settlement report file using its file ID. This operation requires authorization via access token and signature, and returns a download token or error details.

```HTTP
POST /gateway/v2/api/v1/reports/download/token
Authorization: Bearer <YourAccessToken>
Signature: <YourSignature>
Content-Type: application/json

{
  "id": "string"
}
```
Tokens:
Raw