返回結果:

返回示例:

{

  "access_token": "your_access_token",

  "expires_in": 3600,

  "token_type": "Bearer"

}

2.2 接口調用流程

1. 獲取Access Token: 使用客戶端ID和密鑰獲取Access Token。
2. 調用業務接口: 使用獲取到的Access Token調用具體的業務接口。
3. 處理返回結果: 根據接口返回的結果進行相應的業務處理。

2.3 接口參數說明

2.3.1 支付接口

請求URL: https://api.cloudpay.com/v1/payment

請求方法: POST

請求頭:

請求參數:

請求示例:

{

  "order_id": "202310010001",

  "amount": 1000,

  "currency": "CNY",

  "subject": "測試訂單",

  "body": "這是一個測試訂單",

  "notify_url": "https://yourdomain.com/notify",

  "return_url": "https://yourdomain.com/return"

}

返回結果:

返回示例:

{

  "code": 0,

  "message": "success",

  "data": {

    "payment_id": "202310010001",

    "payment_url": "https://pay.cloudpay.com/202310010001"

  }

}

2.3.2 查詢接口

請求URL: https://api.cloudpay.com/v1/query

請求方法: POST

請求頭:

請求參數:

請求示例:

{

  "payment_id": "202310010001"

}

返回結果:

返回示例:

{

  "code": 0,

  "message": "success",

  "data": {

    "status": "SUCCESS",

    "amount": 1000,

    "currency": "CNY",

    "subject": "測試訂單",

    "body": "這是一個測試訂單"

  }

}

2.3.3 退款接口

請求URL: https://api.cloudpay.com/v1/refund

請求方法: POST

請求頭:

請求參數:

請求示例:

{

  "payment_id": "202310010001",

  "refund_amount": 1000,

  "reason": "用戶取消訂單"

}

返回結果:

返回示例:

{

  "code": 0,

  "message": "success",

  "data": {

    "refund_id": "202310010001R",

    "status": "PROCESSING"

  }

}

2.4 接口返回結果

所有接口的返回結果都包含code和message字段，用于表示接口調用的狀態。code為0表示成功，非0表示失敗。data字段包含具體的返回數據，不同接口的data字段結構不同。

2.5 錯誤碼說明

三、常見問題解答（FAQ）

3.1 如何獲取Access Token？

答：通過OAuth 2.0認證機制，使用客戶端ID和密鑰向https://api.cloudpay.com/oauth2/token發送POST請求，獲取Access Token。

3.2 支付接口的notify_url和return_url有什么區別？

答：notify_url用于接收異步通知，支付完成后，空中云付會向該URL發送支付結果通知。return_url用于同步返回，支付完成后，用戶會被重定向到該URL。

3.3 如何處理支付結果通知？

答：支付完成后，空中云付會向notify_url發送POST請求，請求體包含支付結果信息。開發者需要在該URL對應的接口中處理支付結果，并返回success表示處理成功。

3.4 如何查詢支付狀態？

答：使用查詢接口，向https://api.cloudpay.com/v1/query發送POST請求，傳入支付ID，即可查詢支付狀態。

3.5 退款接口的refund_amount可以大于支付金額嗎？

答：不可以。refund_amount必須小于或等于支付金額，否則會返回參數錯誤。

3.6 如何處理退款結果通知？

答：退款完成后，空中云付會向notify_url發送POST請求，請求體包含退款結果信息。開發者需要在該URL對應的接口中處理退款結果，并返回success表示處理成功。

3.7 接口調用失敗怎么辦？

答：首先檢查返回的code和message，根據錯誤碼說明進行排查。如果問題仍未解決，可以聯系空中云付技術支持。

四、結論

空中云付接口提供了豐富的功能和靈活的調用方式，能夠滿足各種支付場景的需求。通過本文的介紹，開發者可以快速掌握空中云付接口的使用方法，并解決常見問題。希望本文能為開發者提供有價值的參考，助力業務發展。

#你可能也喜歡這些API文章!

如何高效爬取全球新聞網站 – 整合Scrapy、Selenium與Mediastack API實現自動化新聞采集