requestPayment
接口说明
requestPayment:options: 用于发起支付请求。
调用方需要传入当前游戏或业务状态对应的 stateHandle,以及支付请求参数 SUDOPRequestPaymentOptions。SDK 会根据传入的订单号、签名数据和签名结果继续处理支付流程。
类型声明
objectivec
@interface SUDOPRequestPaymentOptions : NSObject
@property(nonatomic, copy) NSString *sudTradeNo;
@property(nonatomic, copy) NSString *signData;
@property(nonatomic, copy) NSString *signature;
@end方法声明
objectivec
/**
Requests a payment with the specified state handle and options.
@param stateHandle The state handle object that manages the payment state.
@param options The options configuration for the payment request.
*/
- (void)requestPayment:(id<SUDOPStateHandle>)stateHandle
options:(SUDOPRequestPaymentOptions *)options;参数说明
SUDOPRequestPaymentOptions
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
sudTradeNo | NSString * | 是 | 支付交易订单号,通常由业务服务端生成,用于唯一标识一次支付交易。 |
signData | NSString * | 是 | 签名数据,通常由业务服务端根据支付参数生成。signData 是 JSON 格式的字符串,字段说明见下方。 |
signature | NSString * | 是 | 签名结果,用于校验支付请求的合法性和完整性。 |
signData 字段说明
signData 是一个 JSON 格式的字符串,包含以下字段:
| 字段名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
mode | 是 | String | 支付场景,当前支持的类型有:goods - 道具直购;coin - 游戏币 |
env | 是 | number | 环境配置:0 - 正式环境;1 - 测试环境 |
productId | 特殊 | String | 商品 ID(道具直购场景必填) |
unitPrice | 特殊 | number | 商品单价,单位为分(道具直购场景必填) |
quantity | 是 | number | 购买数量 |
currency | 是 | String | 币种:CNY |
outTradeNo | 是 | String | 业务订单号 |
attach | 否 | String | 透传数据 |
方法参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
stateHandle | id<SUDOPStateHandle> | 是 | 状态句柄对象,用于标识或管理当前支付相关的状态上下文。 |
options | SUDOPRequestPaymentOptions * | 是 | 支付请求参数对象,包含订单号、签名数据和签名结果。 |
使用示例
objectivec
id<SUDOPStateHandle> stateHandle = self.stateHandle;
SUDOPRequestPaymentOptions *options = [[SUDOPRequestPaymentOptions alloc] init];
options.sudTradeNo = @"trade_202405310001";
options.signData = @"your_sign_data";
options.signature = @"your_signature";
[self requestPayment:stateHandle options:options];处理流程
- 业务侧创建支付订单。
- 业务服务端生成
sudTradeNo、signData和signature。 - 客户端创建
SUDOPRequestPaymentOptions对象并填充参数。 - 客户端调用
requestPayment:options:发起支付请求。 - SDK 根据传入参数继续处理支付流程。
- 支付结果通常通过 SDK 回调、游戏状态回调或业务服务端回调进行通知。
注意事项
stateHandle不应为空,否则 SDK 可能无法识别当前支付状态上下文。options不应为空,且应包含完整的支付请求参数。sudTradeNo应保证唯一,避免重复支付或订单状态混乱。signData和signature建议由业务服务端生成,避免在客户端暴露签名密钥。- 如果签名具有有效期,应确保在有效期内调用该接口。
- 该方法无同步返回值,支付最终结果应以回调或服务端订单状态为准。
- 如果该接口会触发支付 UI,建议在主线程调用。
