In-App 对接方案


适用于线下POS支付场景

该该接口用于在商户自有应用(App)中发起支付流程,通过 App-to-App 模式唤起支付应用,实现预授权或一次性支付。

1、商户需自行开发并部署一个应用程序(APK),并安装在POS设备上。

2、在交易发起时,由该商户应用通过 App-to-App 方式调用支付应用,从而完成支付流程。

[!TIP|style:flat]

通过POS机器发起的预授权交易效期有5天,超过5天预授权订单将自动过期。

集成概览

本节介绍商户自研应用(Merchant App)与支付应用(Payment App)之间的核心交互方式,以及基础操作流程。

通过 App-to-App 集成模式,商户应用可在POS设备上直接唤起支付应用,从而完成相关支付操作。

1. 设备查询

获取商户名下的 POS 设备列表及其状态信息(如设备号、序列号等)。

在发起交易前,必须先完成设备查询,以确定目标终端。


2. 发起交易

通过商户应用(Merchant App)以 App-to-App 方式唤起 Switchio Pay 支付应用,完成预授权或一次性支付。

发起支付


3. 通过trade_id映射线上交易订单

通过调用 获取 trade_id 接口获取交易订单的 trade_id 后, 商户云端服务可基于该 trade_id 与自身订单系统进行映射,并执行后续的云端接口调用(如查询、撤销、退款等)。


预授权流程

对于预授权后的相关操作(如金额调整及最终请款),强烈建议通过 API 接口完成,而非通过 POS 终端直接操作。
该方式可提升系统一致性、可控性及交易可追溯性。

可用接口如下:


退款与取消支付

关于退款(包括部分退款)及支付取消流程,请参考以下接口文档:

results matching ""

    No results matching ""