用途:在支付集成中解释支付成功后的税务义务,重点区分两个常被混淆的问题——谁负责收取和上缴税款(merchant of record 问题),以及谁负责开具税务凭证(电子发票问题)。
主要能力:说明 merchant of record 的取舍。当 is_mor 为 true 时,由该服务商向你的客户销售,你向服务商销售;你获得覆盖市场的税务登记、征收、上缴与申报,无需监控 VAT 阈值、OSS 申报或 nexus 追踪,拒付与欺诈由其承担,发票由其代开,覆盖市场无需设立实体;你让出每笔交易比直连收单高 4-6% 的成本、客户账单上显示其名称而非你的、结账品牌与客户关系、按其时间表(常为 14-30 天)结算,以及 mor.disables_capabilities 列出的能力。
电子发票:读取 regions[CODE].tax.einvoice。存在强制要求时,商户须按特定格式、在特定窗口内为每笔销售开具税务凭证,且标识符必须在结账时采集,事后无法补录 RFC、CNPJ 或税号。建议只有两种:使用 merchant of record 由其承担义务,或在结账采集标识符并接入开票服务商。PagoKit 本身不开具税务凭证,只生成 PAGOKIT_TAX_TODO.md,列出强制要求、截止期限和结账必须采集的字段。
美国销售税:经济 nexus 按州判定,由各州不同且会变化的收入或交易阈值触发;home-rule 辖区(如科罗拉多、路易斯安那、阿拉斯加等)由地方自定税率,州级税率表因此是错误的。当 regions.US.tax.home_rule_jurisdictions 设置时,应调用引擎而非自行计算,即数据中的 engine_required。
欧盟 VAT:面向欧盟消费者的数字服务按客户所在地征税;OSS 允许一次申报代替二十七次,但仍须用两份不矛盾证据确定客户位置并保存十年。merchant of record 会吸收全部义务。
使用方式:读取地区的 tax 区块,按名称说明义务,说明由谁履行(merchant of record、开票服务商或用户),若结账须采集税号则明确指出字段,并按实际交易金额给出成本对比。
限制:不提供法律或税务建议,只指出义务与可履行方,用户应向会计师确认;未检查 mor.is_mor 不得声称服务商处理税务;不得混淆征税与开票;在适用 home-rule 辖区时不得把州级税率表当作正确;存在电子发票强制要求的市场不得略过不提。