iOS IAP支付常见问题汇总与解决

1. 获取不到商品信息的原因

  • 沙盒的测试账号和你请求商品信息没有关系
  • iTunes Connect里面对应账号的协议、税务和银行业务信息有没有填完整,填好的应该是这个样子这个很容易疏忽,务必检查
银行税务信息填写完整状态

银行税务信息未填写
  • 确认证书是否添加IAP支付功能默认创建的证书是包含该项的
  • 确定是真机测试且手机没有越狱大部分越狱手机也可以测试,深度越狱破坏系统的可能无法调起支付
  • 确定内购商品添加到了需要内购功能的App
  • 确定当前运行的AppBundle ID和后台配置的AppBundle ID是一致的
  • 可以尝试先删除旧App,再重新编译生成新的,避免新App未覆盖错误
  • 如果上线后发现线上包请求不到商品信息,一般发生于首次提交App或添加新商品,可能是苹果缓存的bug,当你的App通过审核以后,你发现在生产环境下获取不到商品,这是因为App虽然过审核了,但是内购商品还没有正式添加到苹果的服务器里,耐心等待一段时间就可以啦,或者去苹果后台刷新配置商品信息列表,然后等待一天左右时间大概就可以了

2. 如果请求到了商品信息,也发送了购买请求,但是监听购买结果的方法就是不执行

  • 可以检查一下,是否在工具类初始化的时候,添加了监听,添加监听代码如下
  • 注:支付工具类一般用单例模式,避免创建多个对象或者对象提前释放,导致苹果回调不会调用支付失败,或者使用self全局化支付工具类对象,不可使支付工具类对象局部变量化
#pragma mark - 单例方法
static IAPPayManager* instance = nil;
+ (instancetype)sharedInstance{
  static dispatch_once_t onceToken = 0;
  dispatch_once(&onceToken, ^{
      instance = [[IAPPayManager alloc] init];
  });
  return instance;
}

#pragma mark - 重载初始化方法,注册用于处理支付回调的Observer
- (instancetype)init{
    self = [super init];
    if (self) {
        [self registerObserver];
    }
    return self;
}

- (void)registerObserver{
    if(_isAddObserver){
        return;
    }
    [[SKPaymentQueue defaultQueue] addTransactionObserver:self];
    _isAddObserver = true;
}

3. IAP审核环境

  • 苹果在审核App时,只会在sandbox环境购买,其产生的购买凭证,也只能连接苹果的测试验证服务器,审核时后台要保证沙盒测试环境开放,以免服务器无法验证通过IAP购买,造成App审核被拒
  • TestFlight测试时也是走的sandbox环境购买

4. 只要不是红色的状态都是可以进行支付测试的,元数据丢失是因为,在增加内购项目的时候,没有填写完全,产品ID是唯一的,假如你删除了一个内购项目,那么这个产品ID就不能用了,所以填写要慎重

配置内购商品

5. 沙盒测试账号相关
用沙盒账号测试支付的包,只能是adhoc签名证书或者develop签名证书打的包,不能是从AppStore或者TestFlight上下载的,还没上线之前App并没有地区之分,沙盒账号随便哪个地区都可以用来测试,弹出的购买提示框会根据当前沙盒账号AppleID的地区显示语言的

  • 注册沙盒测试账号时,提示报错Unknown Errors while creating Sandbox Tester, Please check Error Log, email=a***st@qq.com
    解决方案:把你的密码设置的复杂点,比如包含数字、字母混大小写等

6. 支付时提示您已购买此App内购买项目。此项目将免费恢复问题

此提示说明iTunes订单被卡住,属于苹果ID支付问题,暂时可先选择其他额度进行支付,也可联系苹果的客服人员删除你异常的订单,打开浏览器进入Apple官方支持
或者可能是addTransactionObserver:调用多次造成,注意要保证一个生命周期只能调用一次该方法

7. 验证服务器地址和需要的参数说明

Key Value 是否必须
receipt-data The base64 encoded receipt data
password Only used for receipts that contain auto-renewable subscriptions. Your app’s shared secret (a hexadecimal string) 否,仅用于自动续订,获取方法见共享密钥附录
exclude-old-transactions Only used for iOS7 style app receipts that contain auto-renewable or non-renewing subscriptions. If value is true, response includes only the latest renewal transaction for any subscriptions 否,仅用于自动续订或非续订订阅的iOS 7样式的应用收据
  • 在测试服务器中,发送receipt到苹果的测试服务器https://sandbox.itunes.apple.com/verifyReceipt验证
  • 在正式服务器中已上线Appstore,发送receipt到苹果的正式服务器https://buy.itunes.apple.com/verifyReceipt验证
  • 当我们把应用提交给苹果审核时,苹果也是在sandbox环境购买,其产生的购买凭证,也只能连接苹果的测试验证服务器,所以我们可以先发到苹果的正式服务器验证,如果苹果返回21007,则再一次连接测试服务器进行验证

8. 苹果返回状态码

Status 描述
0 App Store 验证成功
21000 App Store不能读取你提供的JSON对象
21002 receipt-data属性中的数据格式错误或丢失
21003 receipt无法通过验证
21004 提供的共享密码与帐户的文件共享密码不匹配
21005 receipt服务器当前不可用
21006 该收据有效,但订阅已过期,当此状态代码返回到您的服务器时,收据数据也会被解码并作为响应的一部分返回,仅针对自动续订的iOS 6样式交易收据返回
21007 receipt是Sandbox receipt,但却发送至生产系统的验证服务
21008 receipt是生产receipt,但却发送至Sandbox环境的验证服务
21010 此收据无法授权,就像从未进行过购买一样对待
  • 关于苹果服务器验证返回21004的问题说明
    在购买类型是自动续订时,服务端做验证就要传入这个共享密钥,传入字段为password,共享密钥获取见附录,如果你们的商品不是自动续订,建议不要传入该字段,否则传入内容不正确可能会导致苹果返回21004

  • 关于苹果服务器验证返回21002的问题说明
    如果你们使用key=value&key=value拼接并UTF8编码的方式发送post请求,有可能导致后台接收的数据,里面的+号,变成空格
    解决方案:

  1. 客户端修改,可以参考如下方式解决,建议客户端处理
  2. 如果是线上问题,服务端可以临时修改,当收到21002时,对receipt进行处理String newReceipt = receipt.replace(" ", "+");
if (parameter) {
    NSMutableString * temp = [NSMutableString string];
    NSEnumerator * keyEnum = [parameter keyEnumerator];
    id key;
    while (key = [keyEnum nextObject]) {
        NSString * keyValueFormat = [NSString stringWithFormat:@"%@=%@&", key, [parameter valueForKey:key]];
        [temp appendString:keyValueFormat];
    }
    NSString * result = [temp substringToIndex:temp.length - 1];
    // 处理请求体中包含的如特殊字符,如“+”
    NSString *endResutl = (__bridge_transfer NSString *)CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault, (CFStringRef)result, NULL, CFSTR("+"), kCFStringEncodingUTF8);
    //把参数放到请求体内
    request.HTTPBody = [endResutl dataUsingEncoding:NSUTF8StringEncoding];
}

9. 国内连接苹果服务器的稳定性
开发之初,苹果方就很负责的告知:我们的服务器不稳定。真正开发之后,发现苹果方果然是很负责的,不仅是不稳定,而且足够慢。app store server验证一个收据需要3-6s时间

10. 不允许程序内付费购买道具
当程序调用[SKPaymentQueue canMakePayments]返回NO时,建议查看手机是否限制了购买或者设置了家人共享限制孩子的手机支付,可以参考官方文档 ,如果没有关闭,请向苹果客服反馈

11. 无法连接到iTunes Store
设备网络不稳定或者苹果服务器不稳定的原因,或者越狱设备修改时间导致,可以参考官方文档

12. 经验总结,如下内容已经过验证

  • 程序加入支付队列使用SKMutablePaymentSKPayment的区别
    两者拥有的属性一样,唯一区别是属性读写权限不同,SKMutablePayment属性具有读写权限,SKPayment属性只读,如果你要使用applicationUsername透传字段,那么就一定要使用SKMutablePayment加入支付队列

  • 透传字段applicationUsername可能返回的是nil
    在支付完成后,每笔订单都不调用finishTransaction,如此测试四五笔订单后,重新启动该应用,苹果自动补单会进行,在有些时候该字段就会为空,需要开发者注意

  • updatedTransactions:App整个生命周期只会走一次,所以只要不把订单finishTransaction掉,重启App就会重新走苹果的补单流程(自动调用updatedTransactions:注意需要[[SKPaymentQueue defaultQueue] addTransactionObserver:instance];添加观察者才可以),逻辑需要自己根据项目实现

  • SKPaymentTransaction *transaction属性官方说明

  • transaction.transactionDate
    将订单交易添加到服务器队列的日期,仅当状态为SKPaymentTransactionStatePurchasedSKPaymentTransactionStateRestored时有效

  • transaction.transactionIdentifier
    transactionIdentifier是唯一标识交易支付成功的字符串,此值的格式与收据中的事务transaction_id相同,但是值可能不相同,仅当状态为SKPaymentTransactionStatePurchasedSKPaymentTransactionStateRestored时有效

  • transaction.originalTransaction
    原始交易id,仅当状态为SKPaymentTransactionStateRestored时有效有值

  • transaction.payment.applicationUsername
    获取之前设置的applicationUsername

  • 注意:凭证验证后返回的original_transaction_idtransaction_id一般情况下是相同的,只会在恢复购买时不一样

  • transactionReceiptData可以无限验证通过,也就是说一个凭证可以被校验多次,这是刷单方法之一,需要开发者注意,苹果补单流程返回的transactionReceiptData即使同一笔订单也会变

  • transactionReceiptData验证解析后,in_app字段出现为空或者多个购买项目,只要不finishTransaction掉订单,下次再支付成功后,返回的transactionReceiptData凭证,就是包含之前的购买记录,最近购买的商品会在列表的第一个

  • 验证凭证,苹果服务器返回的数据(iOS 7.0之后接口)

{
  "receipt": {
    "receipt_type": "ProductionSandbox",
    "adam_id": 0,
    "app_item_id": 0,
    "bundle_id": "com.Yo***ights",
    "application_version": "1",
    "download_id": 0,
    "version_external_identifier": 0,
    "receipt_creation_date": "2020-06-01 09:37:57 Etc/GMT",
    "receipt_creation_date_ms": "1591004277000",
    "receipt_creation_date_pst": "2020-06-01 02:37:57 America/Los_Angeles",
    "request_date": "2020-06-01 09:38:55 Etc/GMT",
    "request_date_ms": "1591004335844",
    "request_date_pst": "2020-06-01 02:38:55 America/Los_Angeles",
    "original_purchase_date": "2013-08-01 07:00:00 Etc/GMT",
    "original_purchase_date_ms": "1375340400000",
    "original_purchase_date_pst": "2013-08-01 00:00:00 America/Los_Angeles",
    "original_application_version": "1.0",
    "in_app": [
      {
        "quantity": "1",
        "product_id": "com.yo***thlycard",
        "transaction_id": "10***4780",
        "original_transaction_id": "10***4780",
        "purchase_date": "2020-06-01 09:36:56 Etc/GMT",
        "purchase_date_ms": "1591004216000",
        "purchase_date_pst": "2020-06-01 02:36:56 America/Los_Angeles",
        "original_purchase_date": "2020-06-01 09:36:56 Etc/GMT",
        "original_purchase_date_ms": "1591004216000",
        "original_purchase_date_pst": "2020-06-01 02:36:56 America/Los_Angeles",
        "is_trial_period": "false"
      },
      {
        "quantity": "1",
        "product_id": "com.yo***iteprime1",
        "transaction_id": "10***3950",
        "original_transaction_id": "10***3950",
        "purchase_date": "2020-06-01 09:35:30 Etc/GMT",
        "purchase_date_ms": "1591004130000",
        "purchase_date_pst": "2020-06-01 02:35:30 America/Los_Angeles",
        "original_purchase_date": "2020-06-01 09:35:30 Etc/GMT",
        "original_purchase_date_ms": "1591004130000",
        "original_purchase_date_pst": "2020-06-01 02:35:30 America/Los_Angeles",
        "is_trial_period": "false"
      }
    ]
  },
  "status": 0,
  "environment": "Sandbox"
}
  • 验证凭证,苹果服务器返回的数据(iOS 7.0以前接口)
{
    "receipt": {
        "original_purchase_date_pst": "2023-05-21 19:18:14 America/Los_Angeles",
        "unique_identifier": "00008030-001929E41AE8802E",
        "original_transaction_id": "2000000335096899",
        "item_id": "1602361781",
        "app_item_id": "1596006852",
        "transaction_id": "2000000335096899",
        "quantity": "1",
        "in_app_ownership_type": "PURCHASED",
        "unique_vendor_identifier": "4E51385B-59E1-41B5-9CF2-660B268F10ED",
        "product_id": "com.***.sgsmjz.sea.month",
        "original_purchase_date_ms": "1684721894262",
        "bid": "com.***.sgsmjz.sea",
        "is_in_intro_offer_period": "false",
        "purchase_date_ms": "1684721894262",
        "purchase_date": "2023-05-22 02:18:14 Etc/GMT",
        "is_trial_period": "false",
        "purchase_date_pst": "2023-05-21 19:18:14 America/Los_Angeles",
        "original_purchase_date": "2023-05-22 02:18:14 Etc/GMT",
        "bvrs": "5.7.3"
    },
    "status": 0
}

附:[官方文档] Validating Receipts With the App Store
附:[官方文档] 配置自动续期订阅共享密钥
附:iOS开发内购流程
附:我的博客地址

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容