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 Partners API v2上实现QRPH收款流程时使用本技能。先查看

references/README.md

来选择动态还是静态QRPH，然后阅读对应的参考文件，当需要确切的请求字段、枚举值或响应结构时，使用实时的OpenAPI URL。

如果任务超出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

需要一个固定商户金额、有有效期的一次性二维码？
└─ references/payment-intents.md

需要一个可重复使用、由客户输入金额的二维码？
└─ references/funding-methods.md

需要了解结账、结算或过期webhook的行为？
└─ references/webhooks.md

需要确切的请求或响应字段？
└─ `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.

使用
```
https://api.partners.nextpay.world
```
作为API基础URL。
使用HTTP Basic认证，以Client ID作为用户名，Client Secret作为密码。
阅读
```
references/README.md
```
来选择动态QRPH还是静态QRPH。

阅读

references/payment-intents.md

或

references/funding-methods.md

获取路由列表和操作模型。

当任务涉及结账用户体验、付款准备状态或结算时机时，阅读
```
references/webhooks.md
```
。
阅读实时OpenAPI URL获取当前确切的请求体、枚举值、请求头和响应字段。
当出现
```
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.

支付意图是动态QRPH流程：一次性使用、固定金额、有有效期。
资金方式是静态QRPH流程：可重复使用、由客户输入金额、无有效期。
当前支付意图创建支持
```
automatic
```
、
```
ph_netbank
```
和
```
ph_coins
```
这几种
```
qrph_p2m_reference
```
的服务商选择。
当前公开协议中，资金方式创建的范围较窄，应记录为
```
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

获取当前的实时协议内容。