API - 支付
POST
/v3/merchants/<merchant_id>/payments
提示
- 签名构建因子是入参列表中所有参数；
- 访问时需要将<merchant_id>替换为商户号；
环境域名地址
- 生产环境：
https://gpapi.lianlianpay.com/v3/merchants/<merchant_id>/payments - 沙箱环境：
https://celer-api.LianLianpay-inc.com/v3/merchants/<merchant_id>/payments
接口协议结构体
详情可查看请求与响应结构
请求参数
Header 参数
Body 参数application/json
示例
{
"merchant_transaction_id": "20200808000000008",
"merchant_id": "202103310000001001",
"sub_merchant_id": "202103313321536404",
"notification_url": "https://acquiring.lianlianpay.com/notification",
"redirect_url": "https://acquiring.lianlianpay.com/redirect",
"cancel_url": "https://acquiring.lianlianpay.com/cancel",
"country": "US",
"payment_method": "inter_credit_card",
"additional_info": "{\"site_url\":\"https://www.antoinetton.com\"}",
"merchant_order": {
"merchant_order_id": "20200808000888888",
"merchant_user_no": "100036",
"merchant_order_time": "20221231135923",
"order_description": "测试订单",
"order_amount": 88.88,
"order_currency_code": "USD",
"products": [
{
"product_id": "50306",
"name": "测试商品",
"description": "测试商品描述",
"price": 88.88,
"quantity": 1,
"category": "36321643",
"sku": "775A3TM4",
"url": "https://acquiring.lianlianpay.com/xxx.jpg",
"shipping_provider": "other"
},
{
"product_id": "50306",
"name": "测试商品",
"description": "测试商品描述",
"price": 88.88,
"quantity": 1,
"category": "36321643",
"sku": "775A3TM4",
"url": "https://acquiring.lianlianpay.com/xxx.jpg",
"shipping_provider": "other"
}
],
"shipping": {
"first_name": "san",
"last_name": "Zhang",
"name": "Zhang san",
"phone": "+8618600000000",
"cycle": "24h",
"address": {
"line1": "美国纽约市XXXX",
"line2": "美国纽约市XXXX",
"country": "US",
"city": "NY",
"state": "UT",
"postal_code": "10001",
"district": "Alagoas"
}
}
},
"customer": {
"customer_type": "I",
"first_name": "san",
"last_name": "Zhang",
"full_name": "Zhang san",
"gender": "male",
"id_type": "CPF",
"id_no": "110102199503312837",
"email": "zhangsan@gmail.com",
"phone": "+8618600000000",
"company": "sint nostrud",
"open_id": "27",
"address": {
"line1": "美国纽约市XXXX",
"line2": "美国纽约市XXXX",
"country": "US",
"city": "NY",
"state": "UT",
"postal_code": "10001",
"district": "Alagoas"
}
},
"payment_data": {
"card": {
"holder_name": "Zhang san",
"id_type": "CPF",
"id_no": "1234567890",
"card_no": "4200000000000000",
"card_type": "C",
"bank_code": "214",
"card_brand": "visa",
"card_expiration_year": "30",
"card_expiration_month": "12",
"cvv": "123",
"phone_number": "+8618600000000",
"email": "zhangsan@gmail.com",
"billing_address": {
"line1": "美国纽约市XXXX",
"line2": "美国纽约市XXXX",
"country": "US",
"city": "NY",
"state": "UT",
"postal_code": "10001",
"district": "Alagoas"
}
},
"payment_mode": "subscription",
"subscription_info": {
"recurring_phase": "first",
"previous_merchant_transaction_id": ""
},
"installments": 1
},
"terminal_data": {
"user_order_ip": "",
"user_client_mode": "",
"user_client_app_type": "",
"user_client_android_imei": "",
"user_client_android_sim_id": "",
"user_client_ios_machine_id": "",
"user_client_browser_accept_header": "",
"user_client_browser_color_depth": null,
"user_client_browser_java_enabled": true,
"user_client_browser_js_enabled": true,
"user_client_browser_language": "",
"user_client_browser_screen_height": null,
"user_client_browser_screen_width": null,
"user_client_browser_time_zone_offset": "",
"user_client_browser_user_agent": ""
}
}
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://celer-api.LianLianpay-inc.com/v3/merchants/<merchant_id>/payments' \
--header 'signature: XJqQTCs1QTsp+xO3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9Bg9hfTnOFziCaU0OD3ddYWTMRf13uyLjwwOKD6LWyBCd+17Fq4bBdFcCwiuA6ZUkXbIWKiLACf8gY0JkKpuEvXSSrvHcpS9MPakuXKKwOBRY1UXBhWr2bL3qr8r4bLUk1A3 5ZU7Oj5r2xZV3JrdeFYqBLss1jbXNT9bS4J5JFoFKw/xBzoBkYh7btm28b8i8Q5lY2Vu7vZVK+BGKfBff2PQOJ347VGyR3+ch4qrw0ABRC52jEycWWoGQbnzs6W8DwBGg64/aR7GpNz9sHIy6YW8KwZg==' \
--header 'timezone: Asia/Hong_Kong' \
--header 'timestamp: 20211022160000' \
--header 'Content-Type: application/json' \
--data-raw '{
"merchant_transaction_id": "20200808000000008",
"merchant_id": "202103310000001001",
"sub_merchant_id": "202103313321536404",
"notification_url": "https://acquiring.lianlianpay.com/notification",
"redirect_url": "https://acquiring.lianlianpay.com/redirect",
"cancel_url": "https://acquiring.lianlianpay.com/cancel",
"country": "US",
"payment_method": "inter_credit_card",
"additional_info": "{\"site_url\":\"https://www.antoinetton.com\"}",
"merchant_order": {
"merchant_order_id": "20200808000888888",
"merchant_user_no": "100036",
"merchant_order_time": "20221231135923",
"order_description": "测试订单",
"order_amount": 88.88,
"order_currency_code": "USD",
"products": [
{
"product_id": "50306",
"name": "测试商品",
"description": "测试商品描述",
"price": 88.88,
"quantity": 1,
"category": "36321643",
"sku": "775A3TM4",
"url": "https://acquiring.lianlianpay.com/xxx.jpg",
"shipping_provider": "other"
},
{
"product_id": "50306",
"name": "测试商品",
"description": "测试商品描述",
"price": 88.88,
"quantity": 1,
"category": "36321643",
"sku": "775A3TM4",
"url": "https://acquiring.lianlianpay.com/xxx.jpg",
"shipping_provider": "other"
}
],
"shipping": {
"first_name": "san",
"last_name": "Zhang",
"name": "Zhang san",
"phone": "+8618600000000",
"cycle": "24h",
"address": {
"line1": "美国纽约市XXXX",
"line2": "美国纽约市XXXX",
"country": "US",
"city": "NY",
"state": "UT",
"postal_code": "10001",
"district": "Alagoas"
}
}
},
"customer": {
"customer_type": "I",
"first_name": "san",
"last_name": "Zhang",
"full_name": "Zhang san",
"gender": "male",
"id_type": "CPF",
"id_no": "110102199503312837",
"email": "zhangsan@gmail.com",
"phone": "+8618600000000",
"company": "sint nostrud",
"open_id": "27",
"address": {
"line1": "美国纽约市XXXX",
"line2": "美国纽约市XXXX",
"country": "US",
"city": "NY",
"state": "UT",
"postal_code": "10001",
"district": "Alagoas"
}
},
"payment_data": {
"card": {
"holder_name": "Zhang san",
"id_type": "CPF",
"id_no": "1234567890",
"card_no": "4200000000000000",
"card_type": "C",
"bank_code": "214",
"card_brand": "visa",
"card_expiration_year": "30",
"card_expiration_month": "12",
"cvv": "123",
"phone_number": "+8618600000000",
"email": "zhangsan@gmail.com",
"billing_address": {
"line1": "美国纽约市XXXX",
"line2": "美国纽约市XXXX",
"country": "US",
"city": "NY",
"state": "UT",
"postal_code": "10001",
"district": "Alagoas"
}
},
"payment_mode": "subscription",
"subscription_info": {
"recurring_phase": "first",
"previous_merchant_transaction_id": ""
},
"installments": 1
},
"terminal_data": {
"user_order_ip": "",
"user_client_mode": "",
"user_client_app_type": "",
"user_client_android_imei": "",
"user_client_android_sim_id": "",
"user_client_ios_machine_id": "",
"user_client_browser_accept_header": "",
"user_client_browser_color_depth": null,
"user_client_browser_java_enabled": true,
"user_client_browser_js_enabled": true,
"user_client_browser_language": "",
"user_client_browser_screen_height": null,
"user_client_browser_screen_width": null,
"user_client_browser_time_zone_offset": "",
"user_client_browser_user_agent": ""
}
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"return_code": "SUCCESS",
"return_message": "Success",
"trace_id": "14831.109.16406762306420461",
"order": {
"ll_transaction_id": "202112280336075",
"merchant_transaction_id": "202112281523270200",
"payment_data": {
"payment_currency_code": "USD",
"payment_amount": "1.00",
"exchange_rate": "1.00000000",
"payment_time": "20211228152354",
"payment_status": "PS",
"settlement_currency_code": "USD",
"settlement_amount": "1.00",
"account_date": "20211228"
},
"payment_url": "https://celer-gateway.lianlianpay-inc.com/publish/f654db4c584547149c41951cfe122ec7"
}
}
// 以上例子返回了一个支付成功结果，可以看到 payment_status 为 PS，也就是支付成功，此种请求为同步返回，商户可直接更新自己对应的订单，更多的支付返回结果为中间状态也就是 PP，此种结果为等待异步通知支付的结果；