創建收款單（巴西）
創建巴西雷亞爾（BRL）收款訂單接口。
請求資訊
- 請求 URL：
/gateway/api/v1/payments - 請求方式：
POST - Content-Type：
application/json;charset=utf-8
請求參數
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| platform_id | 是 | String(7) | 商戶 ID |
| service_id | 是 | String(7) | 服務 ID，請填入 SVC0022、SVC0052 |
| payment_cl_id | 是 | String(32) | 商戶訂單號 |
| amount | 是 | Integer(10) | 金額（分） |
| notify_url | 是 | String(256) | 交易結果通知地址 |
| name | 是 | String(16) | 匯款人戶名 |
| last_number | 是 | String(64) | 匯款人 PIX 鑑別碼，接受五種格式：用戶的郵箱/帶國際區號手機號(例如+55XXXXXXX)/CPF/CNPJ/EVP |
| request_time | 是 | Integer(10) | 請求時間（秒） |
| sign | 是 | String(32) | 訂單簽名 |
請求示例
{
"amount": "50000",
"notify_url": "https://xxx.xx/notification",
"payment_cl_id": "DEVPM00014581",
"platform_id": "PF0002",
"request_time": "1595504136",
"service_id": "SVC0022",
"sign": "c81634c1769044eac9e9628a2292f557"
}
返回示例
成功返回
{
"error_code": "0000",
"data": {
"link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D"
}
}
錯誤返回示例
{
"error_code": "0004",
"error_msg": "验签错误!"
}
返回參數說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| error_code | String | 錯誤碼 |
| error_msg | String | 錯誤訊息（error_code 不為 "0000" 時返回） |
| link | String | 訂單收銀地址 |
| amount | Int | 提單金額 |
備註
- 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
- 服務 ID 請填入：
SVC0022收銀台（巴西通道）SVC0052Pix 代收（巴西通道）- 參考 service_id 列表
- 交易金額單位為巴西雷亞爾 BRL（分），請乘以 100 傳入，例如收款 10000.00 請傳值 1000000
- 請求時間使用 Unix timestamp，單位為秒
- 交易結果將通知至
notify_url，請傳入可公開訪問之完整地址（僅支援 http 與 https 協議），參數規範見 交易結果通知