AlipaySDK.h 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223
  1. //
  2. // AlipaySDK.h
  3. // AlipaySDK
  4. //
  5. // Created by antfin on 17-10-24.
  6. // Copyright (c) 2017年 AntFin. All rights reserved.
  7. //
  8. ////////////////////////////////////////////////////////
  9. ///////////////// 支付宝标准版本支付SDK ///////////////////
  10. ///////// version:15.8.11 modify:2022.07.26///////////
  11. ////////////////////////////////////////////////////////
  12. #import <UIKit/UIKit.h>
  13. #import "APayAuthInfo.h"
  14. #import "AFServiceCenter.h"
  15. #import "AFServiceResponse.h"
  16. typedef void(^CompletionBlock)(NSDictionary *resultDic);
  17. typedef enum {
  18. ALIPAY_TIDFACTOR_IMEI,
  19. ALIPAY_TIDFACTOR_IMSI,
  20. ALIPAY_TIDFACTOR_TID,
  21. ALIPAY_TIDFACTOR_CLIENTKEY,
  22. ALIPAY_TIDFACTOR_VIMEI,
  23. ALIPAY_TIDFACTOR_VIMSI,
  24. ALIPAY_TIDFACTOR_CLIENTID,
  25. ALIPAY_TIDFACTOR_APDID,
  26. ALIPAY_TIDFACTOR_MAX
  27. } AlipayTidFactor;
  28. @interface AlipaySDK : NSObject
  29. /**
  30. * 创建支付单例服务
  31. *
  32. * @return 返回单例对象
  33. */
  34. + (AlipaySDK *)defaultService;
  35. /**
  36. * 用于设置SDK使用的window,如果没有自行创建window无需设置此接口
  37. */
  38. @property (nonatomic, weak) UIWindow *targetWindow;
  39. //////////////////////////////////////////////////////////////////////////////////////////////
  40. //////////////////////////支付宝支付相关接口/////////////////////////////////////////////////////
  41. //////////////////////////////////////////////////////////////////////////////////////////////
  42. /**
  43. * 支付接口
  44. *
  45. * @param orderStr 支付订单信息字串
  46. * @param schemeStr 调用支付的app注册在info.plist中的scheme
  47. * @param completionBlock 支付结果回调Block,用于wap支付结果回调
  48. 跳转支付宝支付时只有当processOrderWithPaymentResult接口的completionBlock为nil时会使用这个bolock
  49. */
  50. - (void)payOrder:(NSString *)orderStr
  51. fromScheme:(NSString *)schemeStr
  52. callback:(CompletionBlock)completionBlock;
  53. /**
  54. * 支付接口 v2
  55. *
  56. * @param orderStr 支付订单信息字串
  57. * @param dynamicLaunch 是否使用动态配置策略跳转支付宝支付
  58. * @param schemeStr 调用支付的app注册在info.plist中的scheme
  59. * @param completionBlock 支付结果回调Block,用于wap支付结果回调
  60. 跳转支付宝支付时只有当processOrderWithPaymentResult接口的completionBlock为nil时会使用这个bolock
  61. */
  62. - (void)payOrder:(NSString *)orderStr
  63. dynamicLaunch:(BOOL)dynamicLaunch
  64. fromScheme:(NSString *)schemeStr
  65. callback:(CompletionBlock)completionBlock;
  66. /**
  67. * 处理支付宝app支付后跳回商户app携带的支付结果Url
  68. *
  69. * @param resultUrl 支付宝app返回的支付结果url
  70. * @param completionBlock 支付结果回调 为nil时默认使用支付接口的completionBlock
  71. */
  72. - (void)processOrderWithPaymentResult:(NSURL *)resultUrl
  73. standbyCallback:(CompletionBlock)completionBlock;
  74. /**
  75. * 获取交易token。
  76. *
  77. * @return 交易token,若无则为空。
  78. */
  79. - (NSString *)fetchTradeToken;
  80. //////////////////////////////////////////////////////////////////////////////////////////////
  81. //////////////////////////支付宝授权 2.0 相关接口////////////////////////////////////////////////
  82. //////////////////////////////////////////////////////////////////////////////////////////////
  83. /**
  84. * 快登授权2.0
  85. *
  86. * @param infoStr 授权请求信息字串
  87. * @param schemeStr 调用授权的app注册在info.plist中的scheme
  88. * @param completionBlock 授权结果回调,需要调用方在appDelegate中调用processAuth_V2Result:standbyCallback:方法获取授权结果
  89. * 若在授权过程中,调用方应用被系统终止则此block无效(此时会调用'processAuth_V2Result:standbyCallback:'传入的standbyCallback)
  90. */
  91. - (void)auth_V2WithInfo:(NSString *)infoStr
  92. fromScheme:(NSString *)schemeStr
  93. callback:(CompletionBlock)completionBlock;
  94. /**
  95. * 处理支付宝app授权后跳回商户app携带的授权结果Url
  96. *
  97. * @param resultUrl 支付宝app返回的授权结果url
  98. * @param completionBlock 授权结果回调,用于处理跳转支付宝授权过程中商户APP被系统终止的情况
  99. */
  100. - (void)processAuth_V2Result:(NSURL *)resultUrl
  101. standbyCallback:(CompletionBlock)completionBlock;
  102. //////////////////////////////////////////////////////////////////////////////////////////////
  103. //////////////////////////支付宝授权 1.0 相关接口////////////////////////////////////////////////
  104. //////////////////////////////////////////////////////////////////////////////////////////////
  105. /**
  106. * 快登授权
  107. * @param authInfo 授权相关信息
  108. * @param completionBlock 授权结果回调,若在授权过程中,调用方应用被系统终止,则此block无效,
  109. 需要调用方在appDelegate中调用processAuth_V2Result:standbyCallback:方法获取授权结果
  110. */
  111. - (void)authWithInfo:(APayAuthInfo *)authInfo
  112. callback:(CompletionBlock)completionBlock;
  113. /**
  114. * 处理支付宝app授权后跳回商户app携带的授权结果Url
  115. *
  116. * @param resultUrl 支付宝app返回的授权结果url
  117. * @param completionBlock 授权结果回调
  118. */
  119. - (void)processAuthResult:(NSURL *)resultUrl
  120. standbyCallback:(CompletionBlock)completionBlock;
  121. //////////////////////////////////////////////////////////////////////////////////////////////
  122. //////////////////////////支付宝 h5 支付转 native 支付接口////////////////////////////////////////
  123. //////////////////////////////////////////////////////////////////////////////////////////////
  124. /**
  125. * 从h5链接中获取订单串并支付接口(自版本15.4.0起,推荐使用该接口)
  126. *
  127. * @param urlStr 拦截的 url string
  128. *
  129. * @return YES为成功获取订单信息并发起支付流程;NO为无法获取订单信息,输入url是普通url
  130. */
  131. - (BOOL)payInterceptorWithUrl:(NSString *)urlStr
  132. fromScheme:(NSString *)schemeStr
  133. callback:(CompletionBlock)completionBlock;
  134. //////////////////////////////////////////////////////////////////////////////////////////////
  135. //////////////////////////支付宝 tid 相关信息获取接口/////////////////////////////////////////////
  136. //////////////////////////////////////////////////////////////////////////////////////////////
  137. /**
  138. * 获取当前tid相关信息
  139. *
  140. * @return tid相关信息
  141. */
  142. - (NSString*)queryTidFactor:(AlipayTidFactor)factor;
  143. //////////////////////////////////////////////////////////////////////////////////////////////
  144. //////////////////////////支付宝支付环境相关信息接口//////////////////////////////////////////////
  145. //////////////////////////////////////////////////////////////////////////////////////////////
  146. /**
  147. * 是否已经使用过
  148. *
  149. * @return YES为已经使用过,NO反之
  150. */
  151. - (BOOL)isLogined;
  152. /**
  153. * 获取当前版本号
  154. *
  155. * @return 当前版本字符串
  156. */
  157. - (NSString *)currentVersion;
  158. /**
  159. * 測試所用,realse包无效
  160. *
  161. * @param url 测试环境
  162. */
  163. - (void)setUrl:(NSString *)url;
  164. /**
  165. * 支付前主动更新本地配置
  166. *
  167. * @param block 更新请求结果回调
  168. */
  169. - (void)fetchSdkConfigWithBlock:(void(^)(BOOL success))block;
  170. typedef void(^APLogBlock)(NSString *log);
  171. /**
  172. * 接收AlipaySDK的log信息
  173. *
  174. * @param logBlock 打印log的回调block
  175. */
  176. + (void)startLogWithBlock:(APLogBlock)logBlock;
  177. /**
  178. * 停止输出log,会释放logBlock
  179. *
  180. *
  181. */
  182. + (void)stopLog;
  183. @end