收银台

创建收银台代收（收款）订单。

额外参数	类型	必填	说明
`payment_method`	string	否	限定本订单的支付方式：`card`、`apple_pay` 或 `google_pay`，详见下方「支付方式（可选）」。
`checkout_prefill_*`	string	否	C21 Checkout 页面预填字段，详见下方「Checkout 预填字段（可选）」。

支付方式（可选）

通过 payment_method 将本订单在 TrustPay 收银台中的支付方式限定为一种。

取值	收银台行为
`card`	泛指银行卡支付。在选定渠道账户内，优先使用自建卡表单；不可用时使用渠道卡组件。
`apple_pay`	仅使用 Apple Pay，也接受别名 `applepay`。
`google_pay`	仅使用 Google Pay，也接受别名 `googlepay`。

不传或传空字符串时，保持原有的多支付方式收银台行为。

指定方式必须已为商户启用，并由可用的渠道账户支持；不可用时创建订单失败，不会自动回退到其他支付方式。

创建订单后，支付方式、银行卡实现方式及渠道账户即固定；后续若停用已绑定的方式，不能切换到其他方式继续支付。

本参数不接受 redirect_card、cash_app 及其他不支持的取值。

非空的 payment_method 必须参与请求签名，使用请求中实际发送的原始值；使用别名时也须按该别名计算签名。

此限制作用于 TrustPay 收银台及其渠道支付组件界面，不代表渠道服务端对直接 API 调用实施了仅限特定钱包的限制。

例如，仅允许 Apple Pay 时，在原有请求体中增加 "payment_method": "apple_pay"，并重新计算 sign。

Checkout 预填字段（仅 C21，可选）

curl --location 'https://api.trustpay.money/v4/payin/create/order' \ --header 'Content-Type: application/json' \ --data '{ "currency": "USD", "merchant_id": 8820250900009, "notify_url": "https://webhook.site/7bae2180-3529-4e8e-8d0c-2b894ea3da2c", "order_amount": 20, "order_no": "local-test-payin-12", "sign": "c4a02e0e9270ec884fa050cdf0e916ad" }'

{ "code": 880001, "message": "success", "data": { "order_no": "local-test-payin-12", "platform_order_no": "T4CMQaTCcN05GEx9EQkuabB1", "currency": "USD", "order_amount": 20, "fee": 4.5, "pay_url": "https://pay.goopter.com/checkout.html?token=9cdfe051de03b615b74b410e" } }

支付方式（可选）

Request

Responses

收银台

支付方式（可选）#

Request

Responses

支付方式（可选）