送金通知 API
テスト用エンドポイント:
https://transact.ti.com/v2/store/remittance-advice/test
正式運用エンドポイント:
https://transact.ti.com/v2/store/remittance-advice
送金通知 API を使用すると、お支払いの詳細を確証する送金通知情報を送信することができます。各要求に、ヘッダーと品目の両方のセクションを記述する必要があります。ヘッダー セクションには、顧客の送金通知と通貨コード情報が記載されています。品目セクションには、具体的な支払い情報と財務資料情報を含め、1 つまたは任意の数の詳細なレコードを記述することができます。
注: 送金通知 API を使用できるのは、TI のクレジット ライン (与信限度) を指定しているお客様のみです。
送金通知フロー
- 貴社の API キーとシークレットを使用して、認証を受けます。
- 貴社のアクセス トークンを受け取った後、必要な情報を指定した要求を送信します。アクセス トークンの有効期限が切れていない限り、そのアクセス トークンを使用して同じセッションで複数の要求を行うことができます。
- この 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" }
]
}