qrph

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

NextPay QRPH

Overview

概述

Use this skill for QRPH money-in flows on NextPay Partners API v2. Start with

references/README.md

to choose between dynamic and static QRPH, then read the matching reference file, and use the live OpenAPI URL when exact request fields, enums, or response shapes matter.

Use

$nextapi

instead when the task goes beyond QRPH collection into merchants, accounts, payouts, or general integration work.

本使用说明适用于NextPay合作伙伴API v2的QRPH资金流入流程。请先阅读

references/README.md

来选择动态或静态QRPH方案，再阅读对应的参考文档，当需要精确的请求字段、枚举值或响应结构时，请使用实时OpenAPI地址。

如果任务超出QRPH收款范畴，涉及商户、账户、打款或通用集成工作，请改用

$nextapi

。

Freshness

时效性说明

Treat the markdown references as workflow guides. Use

https://api.partners.nextpay.world/v2/openapi

as the source of truth for current wire shapes and enum values.

请将Markdown参考文档作为流程指南使用。将

https://api.partners.nextpay.world/v2/openapi

作为当前传输结构和枚举值的唯一可信来源。

Quick Decision Tree

快速决策树

text

Need a one-time QR with a fixed merchant amount and expiry?
└─ references/payment-intents.md

Need a reusable QR where the customer chooses the amount?
└─ references/funding-methods.md

Need to understand checkout, settlement, or expiry webhook behavior?
└─ references/webhooks.md

Need exact request or response fields?
└─ `https://api.partners.nextpay.world/v2/openapi`

text

Need a one-time QR with a fixed merchant amount and expiry?
└─ references/payment-intents.md

Need a reusable QR where the customer chooses the amount?
└─ references/funding-methods.md

Need to understand checkout, settlement, or expiry webhook behavior?
└─ references/webhooks.md

Need exact request or response fields?
└─ `https://api.partners.nextpay.world/v2/openapi`

Workflow

工作流程

Use
```
https://api.partners.nextpay.world
```
as the API base URL.
Use HTTP Basic Auth with the Client ID as the username and the Client Secret as the password.
Read
```
references/README.md
```
to choose between dynamic QRPH and static QRPH.

Read

references/payment-intents.md

references/funding-methods.md

for the route shortlist and operational model.

Read
```
references/webhooks.md
```
when the task involves checkout UX, payout readiness, or settlement timing.
Read the live OpenAPI URL for exact current request bodies, enums, headers, and response fields.
Explain
```
PHP/2
```
whenever it appears. Precision notation means the integer amount stores minor units, so
```
10000
```
means PHP 100.00.

API基础URL使用
```
https://api.partners.nextpay.world
```
。
采用HTTP Basic Auth认证，用户名填写Client ID，密码填写Client Secret。
阅读
```
references/README.md
```
，选择动态QRPH或静态QRPH方案。

阅读

references/payment-intents.md

或

references/funding-methods.md

了解可用接口列表和运营模型。

如果任务涉及结账UX、打款就绪状态或结算时机，请阅读
```
references/webhooks.md
```
。
查阅实时OpenAPI地址获取当前最新的请求体、枚举值、请求头和响应字段的精确说明。
出现
```
PHP/2
```
时请予以解释：该精度标识表示整数值存储的是最小货币单位，因此
```
10000
```
代表PHP 100.00。

QRPH Rules

QRPH规则

Payment intents are dynamic QRPH flows: one use, fixed amount, expiring.
Funding methods are static QRPH flows: reusable, customer-entered amount, non-expiring.
Payment intent creation currently supports
```
automatic
```
,
```
ph_netbank
```
, and
```
ph_coins
```
provider selection for
```
qrph_p2m_reference
```
.
Funding method creation is narrower in the current public schema and should be documented as
```
ph_netbank
```
plus
```
qrph_p2m_reference
```
.
Prefer
```
X-Idempotency-Key
```
on QRPH create endpoints to avoid duplicate side effects on retries.
Do not promise an expiry webhook. Expiry is represented by
```
expires_at
```
, so fetch the resource if confirmation is needed.
Treat
```
v2.payment_instrument.payment_received
```
as the earliest positive payment acknowledgment,
```
v2.payment_instrument.payment_settled
```
as the stronger settlement signal, and
```
v2.payment_intent.succeeded
```
as the one-time business completion event.

支付意图（Payment intent）属于动态QRPH流程：单次使用、金额固定、可过期。
资金方式（Funding method）属于静态QRPH流程：可复用、金额由客户输入、永久有效。
当前创建支付意图时，
```
qrph_p2m_reference
```
支持选择
```
automatic
```
、
```
ph_netbank
```
和
```
ph_coins
```
三种服务商。
当前公开Schema中创建资金方式的可选范围更小，应当标注为
```
ph_netbank
```
加
```
qrph_p2m_reference
```
。
建议在QRPH创建接口上使用
```
X-Idempotency-Key
```
，避免重试时产生重复副作用。
请勿承诺提供过期webhook，过期状态通过
```
expires_at
```
字段标识，若需要确认请拉取资源信息。
将
```
v2.payment_instrument.payment_received
```
视为最早的支付成功确认信号，
```
v2.payment_instrument.payment_settled
```
视为更可靠的结算信号，
```
v2.payment_intent.succeeded
```
视为一次性业务完成事件。

References

参考资料

Read
```
references/README.md
```
first for dynamic versus static QRPH routing.
Read
```
references/payment-intents.md
```
for one-time QRPH generation and lookup.
Read
```
references/funding-methods.md
```
for reusable QRPH generation and lookup.
Read
```
references/webhooks.md
```
for QRPH webhook semantics and timing nuance.

Read

https://api.partners.nextpay.world/v2/openapi

for the live current contract.

首先阅读
```
references/README.md
```
了解动态与静态QRPH的路由选择。
阅读
```
references/payment-intents.md
```
了解一次性QRPH的生成和查询方法。
阅读
```
references/funding-methods.md
```
了解可复用QRPH的生成和查询方法。
阅读
```
references/webhooks.md
```
了解QRPH webhook的语义和时机细节。

阅读

https://api.partners.nextpay.world/v2/openapi

获取实时最新的接口规约。