1. Payment Gateway
TrustPay
en
  • en
  • zh
  • Integration Guide
  • Signature Calculation
  • Payment Gateway
    • Risk Control – Merchant Integration
    • Enums
    • Payment Callback Specification
    • C21 Suport Regions
      • TrustPay Supported Billing Countries and US/Canada Regions
    • Whitelist Management
      • Add Card Whitelists
      • Query Card Whitelists
      • Query Card Whitelists Task
    • Card Direct Payin
      POST
    • Cashier Payin
      POST
    • Order Refund
      POST
    • Payment Callback
      POST
    • Balance
      POST
    • Order Query
      POST
    • Fee Query
      POST
    • Refund Query
      POST
  • Dispute Management
    • Dispute Enums
    • Dispute Alert
    • Dispute Alert Callback
    • Dispute Prevention (RDR)
    • Dispute Management(Chargeback)
    • Chargeback Callback
  • Credit Card Issuer
    • Available Card
      POST
    • Open Card
      POST
    • Open/Recharge Card Callback
      POST
    • Get Card Detail
      POST
    • Card Recharge
      POST
    • Order List
      POST
    • Card List
      POST
    • Transaction List
      POST
    • Fee Query
      POST
  • Physical Card Issuer
    • Create Cardholder
    • List Cardholders
    • Assign Physical Cards
    • List Assigned Physical Cards
    • Query Card Balance
    • Query Card Transactions
    • Query Account
    • Card Charge
  • Schemas
    • VCardDetail
    • VOrderDetail
  1. Payment Gateway

Cashier Payin

POST
/v4/payin/create/order
Create a cashier counter collection (payment collection) order.
Extra ParameterTypeRequiredDescription
payment_methodstringNoRestrict checkout to card, apple_pay, or google_pay. See Payment Method (Optional) below.
checkout_prefill_*stringNoOptional prefilled values for the C21 Checkout page. See Checkout Prefill Fields (Optional) below.

Payment Method (Optional)#

Use payment_method to restrict this order to one payment method in the TrustPay checkout flow.
ValueCheckout behavior
cardBank card payment. Prefer the self-built card form when available on the selected account; otherwise use the provider card component.
apple_payApple Pay only. applepay is also accepted.
google_payGoogle Pay only. googlepay is also accepted.
Omit the field or send an empty string to keep the existing multi-method checkout behavior.
The requested method must be enabled for your merchant and supported by an available channel account. If it is unavailable, order creation fails; there is no automatic fallback to another payment method.
The payment method, card implementation, and channel account are fixed after order creation. If the bound method is later disabled, checkout cannot continue using another method.
redirect_card, cash_app, and other unsupported values are not accepted by this parameter.
Include every non-empty payment_method value in the request signature, using exactly the value sent in the request (including an alias, if used).
This restriction applies to TrustPay checkout and its provider UI; it does not establish a provider-side wallet-only policy for direct provider API calls.
To request Apple Pay, add "payment_method": "apple_pay" to the existing request body and recalculate sign.

Checkout Prefill Fields (C21 Only, Optional)

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.trustpay.money/v4/payin/create/order' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "USD",
    "merchant_id": 8820250900009,
    "notify_url": "https://rbaskets.trustpay.money/checkout",
    "order_amount": 20.00,
    "order_no": "local-payin-440",
    "sign": "c4a02e0e9270ec884fa050cdf0e916ad"
}'
Response Response Example
{
    "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"
    }
}
Modified at 2026-10-16 04:12:24
Previous
Card Direct Payin
Next
Order Refund
Built with