﻿# 接口集成
商户通过一次性接入PayerMax收银台支付服务能力，即可在移动端和Web端集成东南亚、中东、拉美等地区的在线收款方式，如借记卡、信用卡、电子钱包等，轻松具备当地业务的收款能力。
### 1. 集成步骤

![](https://img-cdn-sg.payermax.com/public/20240724-879c5216-966d-4517-a629-9b2c863bf5d0.jpg)

### 2. 订单幂等性校验
商户提交收银台支付请求时，上送的订单号需要保证唯一。
下单接口支持幂等，如调用失败，请按错误码进行调整后，继续同单号下单。如果下单请求已成功，再次用同单号请求时，会返回订单号重复。如果该笔订单待支付，则会将之前的收银台地址重新返回。如有特殊诉求，请联系PayerMax技术支持

### 3. 接口参数
详情参阅：[接口参数](https://docs.payermax.com/api.html?docName=New%20Version&docVer=v1.0&docLang=cn#/paths/aggregate-pay-api-gateway-orderAndPay/post)

### 4. 指定支付方式
收银台支付支持指定支付方式下单，以满足商户在自己的收银台露出支付方式。
#### 4.1 非CARD类的支付方式
- 商户如果希望只展示某一类支付方式时（如CarrierBilling，BankTransfer），可以上送列表中支持的支付方式类型paymentMethodType，PayerMax会在拉取收银台时只展示该paymentMethodType的目标机构。
- 商户如果希望指定请求特定的目标机构，则需要同时指定支付方式类型paymentMethodType和目标机构targetOrg，PayerMax将只会给用户展示商户指定的paymentMethodType和targetOrg。

#### 4.2 CARD类的支付方式
当指定paymentMethodType为CARD时，目标机构targetOrg不需要上送，如需指定卡组织，则需要指定cardOrg。

::: warning 注意：
支持的支付方式和目标机构/卡组织列表参见[【收银台支付-支付方式列表】](https://docs.payermax.com/202606-version/receipt/cashier/payment-method/southeast-asia.md)，支付方式下支持哪些目标机构，以及对应的限额，关单时间等会随着PayerMax支持的能力变化而随时更新。
:::
