Quick Start - QFPay Developer Centre

Overview

This quick start walks you through creating a payment request and receiving a payment notification.

Step 1 — Prepare credentials

View required credentials

To use the QFPay OpenAPI, you need:

app_code
client_key
mchid (if provided)

If you do not have credentials, contact QFPay support.

Step 2 — Prepare request parameters

View example request parameters

{
  "app_code": "YOUR_APP_CODE",
  "out_trade_no": "ORDER_1001",
  "total_fee": "100",
  "pay_type": "801",
  "notify_url": "https://example.com/callback"
}

Step 3 — Generate request signature

How to generate the signature

Sign all request parameters using your client_key.See Signature Generation for full instructions.

Step 4 — Send payment request

API request example

POST https://api.qfapi.com/trade/v1/payment
Content-Type: application/json

Step 5 — Handle the response

Successful response example

{
  "respcd": "0000",
  "pay_url": "https://..."
}

Use the returned URL or QR code to complete payment.

Step 6 — Receive payment notification

Payment notification details

QFPay sends an asynchronous notification to your notify_url when payment is completed.Ensure your endpoint:

accepts POST requests
returns HTTP 200 upon success
verifies the signature

Optional: Test locally

Expose your callback URL

Use ngrok or similar tools to receive notifications:

ngrok http 8080

Test with Postman

Import the Postman collection to send test requests:https://sdk.qfapi.com/assets/files/qfpay_openapi_payment_request.postman_collection-c8de8c8fe69f3fcd5a7653d41c289a29.json

Next Steps

Authentication & Signing

Learn how to sign requests securely.

Async Notifications

Handle payment status updates.

Payment Types

View supported payment codes.

Testing & Environments

Use sandbox for testing.

Introduction

⌘I

​Overview

​Step 1 — Prepare credentials

​Step 2 — Prepare request parameters

​Step 3 — Generate request signature

​Step 4 — Send payment request

​Step 5 — Handle the response

​Step 6 — Receive payment notification

​Optional: Test locally

​Next Steps