com.xpay.sdk.intl.model

Class PaymentOrderCreateRequest

java.lang.Object

com.xpay.sdk.intl.model.PaymentOrderCreateRequest

public class PaymentOrderCreateRequest
extends Object

创建国际版收款订单的请求模型。

字段按开发者平台 lowerCamelCase 协议直接序列化；merchantOrderNo 同时承担创建幂等和查单关联。 SDK 只承载公开产品合同，不推导渠道、银行或处理器参数，服务端负责权限、产品和金额的最终 fail-close 校验。

Field Summary

Fields

Modifier and Type	Field and Description
Amount	amount 创建金额对象，只包含大于零的主单位字符串 value，不能为空。
Map<String,String>	customData 可选商户关联数据，允许为空，最多 20 个 lowerCamelCase 字符串键值；不参与幂等、路由、清算或风控。
String	merchantOrderNo 商户订单号，同一商户下用于创建幂等和查单，长度 5 至 32，不能为空。
String	orderDescription 商户侧订单或商品描述，不能为空，最长 128 字符；不得包含敏感数据。
Payer	payer 付款人联系方式；孟加拉代收产品要求提供邮箱，响应和通知可返回付款人摘要，手机号只返回后四位。
String	productCode 平台为商户开通的收款产品编码，长度 1 至 32；调用方应视为不透明值，不能为空。
String	successUrl 支付成功后返回商户的可选 HTTPS 地址，最多 2048 ASCII 字节，无需提前登记域名；null 时不序列化。

Constructor Summary

Constructors

Constructor and Description
PaymentOrderCreateRequest()

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

merchantOrderNo

public String merchantOrderNo

商户订单号，同一商户下用于创建幂等和查单，长度 5 至 32，不能为空。

productCode

public String productCode

平台为商户开通的收款产品编码，长度 1 至 32；调用方应视为不透明值，不能为空。

amount

public Amount amount

创建金额对象，只包含大于零的主单位字符串 value，不能为空。

orderDescription

public String orderDescription

商户侧订单或商品描述，不能为空，最长 128 字符；不得包含敏感数据。

successUrl

public String successUrl

支付成功后返回商户的可选 HTTPS 地址，最多 2048 ASCII 字节，无需提前登记域名；null 时不序列化。 原文参与请求签名和业务幂等，受理后不可增加、修改或删除；平台不追加状态或订单参数。纯 QRPH 不支持。 服务端负责地址及产品能力的 fail-close 校验；SDK 不裁剪、编码或归一化。浏览器返回不是支付凭证， 履约必须依赖服务端查单或验签通知。

payer

public Payer payer

付款人联系方式；孟加拉代收产品要求提供邮箱，响应和通知可返回付款人摘要，手机号只返回后四位。

customData

public Map<String,String> customData

可选商户关联数据，允许为空，最多 20 个 lowerCamelCase 字符串键值；不参与幂等、路由、清算或风控。 禁止放入 API/Webhook 密钥、签名、认证 Token、银行卡号、完整收款账号、手机号、邮箱等敏感信息； 代收付款人联系方式应使用 payer；幂等重复请求只返回首次受理请求保存的不可变快照，后续请求 不会合并或覆盖。

Constructor Detail

PaymentOrderCreateRequest

public PaymentOrderCreateRequest()