匯款通知 API

測試端點:
https://transact.ti.com/v2/store/remittance-advice/test

生產端點:
https://transact.ti.com/v2/store/remittance-advice

匯款通知 API 可讓您提交匯款通知資訊,以確認您的付款詳細資訊。每個請求皆必須包含標頭和項目區段。標頭區段可識別客戶的匯款通知與貨幣代碼資訊。項目區段可包含一或多筆詳細記錄,以及特定付款和財務文件資訊。

附註: 匯款通知 API 僅適用於具有 TI 信用額度的客戶。

匯款通知流程

  1. 進行驗證,方法為使用您的 API 金鑰和秘密。
  2. 收到存取權杖後,請傳送內含所需資訊的要求。只要權杖尚未過期,就可以在同一個工作階段中使用存取權杖進行多個要求。
  3. API 將會回覆狀態代碼 200 OK,以及包含確認的 JSON 字串。

請求範例:

{
  "remittanceAdviceNumber": "CustomerRemit100",
  "currencyCode": "USD",
  "lineItems": [
{       "paymentAmount": "2000",       "financialDocumentNumber": "1234567890"     }
,
{       "paymentAmount": "200",       "financialDocumentNumber": "234567890"     }
  ]
}


範例回應:

{
  "tiRemittanceAdviceNumber": "06CustomerRemit100",
  "remittanceAdviceNumber": "CustomerRemit100",
  "currencyCode": "USD",
  "messages": [
{       
  "code": "TI-TXT-012013",       
  "type": "SUCCESS",      
  "reason": "Remittance Advice 06CustomerRemit1 posted.",       
  "message": "Remittance Advice 06CustomerRemit1 posted."     }
  ],
  "lineItems": [
{       "paymentAmount": "2000",       "financialDocumentNumber": "1234567890"     }
,   
{       "paymentAmount": "200",       "financialDocumentNumber": "234567890"     }
  ]
}