Skip to content

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 ​

参数类型是否必填说明
sudTradeNoNSString *是支付交易订单号,通常由业务服务端生成,用于唯一标识一次支付交易。
signDataNSString *是签名数据,通常由业务服务端根据支付参数生成。signData 是 JSON 格式的字符串,字段说明见下方。
signatureNSString *是签名结果,用于校验支付请求的合法性和完整性。

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透传数据

方法参数 ​

参数类型是否必填说明
stateHandleid<SUDOPStateHandle>是状态句柄对象,用于标识或管理当前支付相关的状态上下文。
optionsSUDOPRequestPaymentOptions *是支付请求参数对象,包含订单号、签名数据和签名结果。

使用示例 ​

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];

处理流程 ​

  1. 业务侧创建支付订单。
  2. 业务服务端生成 sudTradeNo、signData 和 signature。
  3. 客户端创建 SUDOPRequestPaymentOptions 对象并填充参数。
  4. 客户端调用 requestPayment:options: 发起支付请求。
  5. SDK 根据传入参数继续处理支付流程。
  6. 支付结果通常通过 SDK 回调、游戏状态回调或业务服务端回调进行通知。

注意事项 ​

  • stateHandle 不应为空,否则 SDK 可能无法识别当前支付状态上下文。
  • options 不应为空,且应包含完整的支付请求参数。
  • sudTradeNo 应保证唯一,避免重复支付或订单状态混乱。
  • signData 和 signature 建议由业务服务端生成,避免在客户端暴露签名密钥。
  • 如果签名具有有效期,应确保在有效期内调用该接口。
  • 该方法无同步返回值,支付最终结果应以回调或服务端订单状态为准。
  • 如果该接口会触发支付 UI,建议在主线程调用。