Qodex.ai

Example with creditor agent using a domestic identification

POST {{baseUrl}}/swift-preval/FeeStatistics/v1/payments/fee-statistics

This API provides end user insights at payment initiation and aims at enhancing end customer (upfront) predictability of cross-border payments. A requestor agent can use it to obtain statistics for past payments it sent to a specific creditor agent. These statistics are related to the end-to-end transactions fees (deducts), creditor agent fees (deducts) and processing time, based on past Swift transaction data. The requestor agent decides whether to provide the obtained statistics to the end user based on the statistics confidence level. The requestor agent would initiate the payment once approved by the end user.

Request Body

{"requestor_agent"=>{"bicfi"=>"BNKBDEFFXXX"}, "creditor_agent"=>{"clearing_system_member_identification"=>{"clearing_system_identification"=>"USABA", "member_identification"=>"123456789"}}, "amount"=>{"currency"=>"USD", "amount"=>"950"}}

HEADERS

KeyDatatypeRequiredDescription
x-bicstring(Required) BIC of the Payment Pre-validation Data Provider. The x-bic value must correspond to the BIC of the beneficiary bank subscribed to the service as Data Provider and performing the beneficiary account validation.
X-Request-IDstringUnique end-to-end tracking identifier(ID) of the Payment Pre-validation API service request. Payment Pre-validation users are not required to fill it in for the Payment Pre-validation API request. SWIFT provide the tracking ID which is an uuid as described in IETF RFC 4122 Universally Unique Identifier (UUID) URN Namespace. Pattern - ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$.
X-Request-Date-TimestringThe timestamp of the request, based on the client's clock. Request date time must be created and supplied at the time of request. The date-time must be represented as specified in RFC 7231. For example - Sun, 06 Nov 1994 08:49:37 GMT.
Content-Typestring
Acceptstring