Paycools Partner API Docs
Languages
Languages
  • 中文
  • English
Languages
Languages
  • 中文
  • English
    • Unified API Request Param
    • Unified Async Notification Param
    • Open API Common Code List
    • 1. Merchant Onboarding
      • KYC Info Enum
      • Kyc bank List
      • 1.1 Merchant Register
        POST
      • 1.2 Commit KYC
        POST
      • 1.3 Get Merchant KYC Information
        POST
      • 1.4 Upload File - File
        POST
      • 1.5 Merchant Auth Status Search
        POST
      • 1.6 Merchant KYC Status Change Notice
        POST
      • 1.7 Resubmit KYC information
        POST
    • 2. Account
      • Country Code
      • 2.1 Balance Inquiry
        POST
      • 2.2 Report Download
        POST
    • 3. Payment
      • Payment Channel List
      • 3.1 Create Payment
        POST
      • 3.2 Check Payment Status
        POST
      • 3.3 Payment Notification
        POST
    • 4. Checkout
      • Checkout Payment Channel Code List
      • 4.1 Create Checkout Order
        POST
      • 4.2 Check Checkout Order status
        POST
      • 4..5 Payment Notification
        POST
      • 4.3 Get Checkout Order Available Channels
        POST
      • 4.4 Close Checkout Order
        POST
    • 5. Refund
      • Refund Support Channel List
      • Refund Status Enum
      • 5.1 Refund
      • 5.2 Get Refund Payments
      • 5.3 Refund Notification
    • 6. Split Payment
      • Split Payment Enumeration
      • 6.1 Relationship Proof File Upload
      • 6.2 Add Split Payment Receiver
      • 6.3 Query Split Payment Receiver
      • 6.4 Delete Split Payment Receiver
      • 6.5 Query Unsplit Amount
      • 6.6 Split Payment
      • 6.7 Query Split Payment Result
      • 6.8 Split Payment Return
      • 6.9 Query Split Payment Return Result API
    • 7. Direct Debit
      • Direct Debit Channel List
      • 7.1 Create Authorization Url
      • 7.2 Check Authorization Status
      • 7.3 Cancel Authorization
      • 7.4 Asynchronous Notification Of Authorization Results

    Open API Common Code List

    API Common Code List (real time return of error code)
    response example
    {
        "code":21016,
        "message":"Merchant ip forbidden",
    }

    Common Response Code#

    responseCoderesponseMessage
    10000Success
    21000Server error, Please try again later.
    21001Request sign error
    21002Request param error
    21003Request appId error
    21004Merchant info error
    21005Merchant channel is unavailable
    21006Merchant transaction not found
    21007Duplicate merchant order id
    21008Request timestamp error
    21009Request timestamp error
    21010The amount exceeds the limit
    21011Network error
    21012Request bank code error
    21013Request wallet code error
    21014Merchant balance insufficient
    21015Duplicate idempotencyId
    21016Merchant ip forbidden
    21017Merchant has not opened this national service
    21018Request transfer code error
    21019Request pay method code error
    21020Too many requests, please retry later.
    21021Transaction Amount Invalid
    21022Transaction Volume Limit
    21023Transaction create failed
    21024Invalid access token
    21025Not allowed to cancel
    21026Customer Balance not enough
    21027Transaction creation exceeds limit
    21028Transaction already paid or closed
    21046The merchant does not exist
    21052The merchant name already exists
    21057The merchant has not yet enabled the service provider function

    Refund Response Failed Code#

    responseCoderesponseMessage
    21401Refund is processing
    21402Not allowed to refund
    21403Transactions 60 days ago cannot initiate refunds
    21404The original transaction channel not support full refund
    21405The original transaction channel not support partial refund
    21406Refund amount invalid
    21407MchRefundOrderId is repeat
    21408The original transaction is not completed
    21409The original transaction already exist pending refund

    Void Response Failed Code#

    responseCoderesponseMessage
    21500Original transaction status is not success
    21501Cannot reverse
    21502Original transaction has been settled
    21503Cannot void over the day
    21504Original transaction has been already voided
    21505Duplicate mchVoidOrderID detected. Please provide a unique mchvoidOrderID and retry.

    Open API Transaction Failed Code List#
    Used for transaction query or callback results
    response data example
    {
    	"amount":5735,
    	"createTime":"2022-01-10 17:55:45",
    	"eventName":"disbursement.failed",
    	"failedCode":1001,
    	"failedMessage":"Transaction Exceed Limit",
    	"mchOrderId":"CCP16418085446081",
    	"remark":"cash credit",
    	"returnTime":"2022-01-10 18:33:37",
    	"sign":"5a9dd499ddf1c2a4dcf054aceafe409b45f37ca6",
    	"transactionId":"d149b0a575e5344740b2d9698babcede1f68",
    	"transactionStatus":"FAILED"
    }
    failedCodefailedMessage
    -10000Transaction Service Error
    -10001Transaction Exceed Limit
    -10002Transaction Params Error
    -10003Transaction Insufficient Balance
    -10004Transaction Channel Rejected
    -10005Transaction Destination Account Error
    -10006Transaction Network Reject
    -10007Transaction Channel Temporarily Close
    -10008Merchant Unavailable Error
    -10009Recipient Account Blocked
    -10010Channel Refund Failed

    Open API Transaction Status List#
    Both of Collection and Disburse
    transaction statusdescription
    PENDINGtransaction pending
    COMPLETEDtransaction successful
    FAILEDtransaction failed
    VOIDEDtransaction voided

    商户进件错误码#

    响应码响应信息
    21047The merchant is not in BACK status, cannot resubmit
    21048The merchant has been REJECTED, cannot resubmit
    21049The merchant has not submitted KYC yet, please use commitKyc
    21050The merchant is under review, please wait for the result
    21051The merchant has been approved, no need to resubmit
    21053Document has expired
    上一页
    Unified Async Notification Param
    下一页
    KYC Info Enum
    Built with