創建PaymentLink H5 頁面

测试环境

https://test-api.chingchingpay.com/gateway

POST

/api/v1/payments/link

Last modified:2025-03-25 01:43:51

創建PaymentLink H5 頁面

Request

Header Params

x-api-key

string

optional

Default:

x-signature

string

optional

Body Params application/json

amount

integer

required

交易金额單位: 分

callback_url

string

optional

交易回调地址

cancel_url

string

optional

交易取消時，頁面回傳地址

complete_url

string

optional

交易成功時，頁面返回地址

currency

string

required

交易幣種

description

string

optional

交易描述

device_id

string

optional

设备ID

expires_at

string

optional

交易过期时间戳

merchant_id

string

required

商户ID

merchant_reference

string

required

商家參考號

payment_type

string

optional

支付類型: link,checkout

store_id

string

optional

商店ID

Example

{
  "amount": 0,
  "callback_url": "string",
  "cancel_url": "string",
  "complete_url": "string",
  "currency": "string",
  "description": "string",
  "device_id": "string",
  "expires_at": "string",
  "merchant_id": "string",
  "merchant_reference": "string",
  "payment_type": "string",
  "store_id": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-api.chingchingpay.com/gateway/api/v1/payments/link' \
--header 'x-api-key: ' \
--header 'x-signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 0,
    "callback_url": "string",
    "cancel_url": "string",
    "complete_url": "string",
    "currency": "string",
    "description": "string",
    "device_id": "string",
    "expires_at": "string",
    "merchant_id": "string",
    "merchant_reference": "string",
    "payment_type": "string",
    "store_id": "string"
}'

Responses

🟢200OK

application/json

Body

code

integer

optional

data

object

v1.CreatePaymentResponse

optional

merchant_reference

string

optional

商家訂單編號

payment_id

string

optional

支付ID

payment_link

string

optional

支付链接

status

string

optional

订单状态

message

string

optional

Example

{
  "code": 0,
  "data": {
    "merchant_reference": "string",
    "payment_id": "string",
    "payment_link": "string",
    "status": "string"
  },
  "message": "string"
}

發起退款交易