8.2 FX Deal Booking – REST Service (External Request)

This topic provides the systematic instructions for FX deal booking - rest service.

A new REST service has been developed to handle FX deal booking requests received from an external system.

Deal Booking Request Received

1. The external system calls the OBTR FX Deal Booking Service API, passing:
   • Deal details
   • Quote ID received from the rate quote service.

Booking Deal with Rate Provider

2. OBTR calls the relevant rate service provider API to book the deal, passing:
   • Quota reference
   • Required deal parameters (per provider API specification)

Booking in OBTR

3. After OBTR receives confirmation from the rate provider (including the provider’s booking/external reference), OBTR books two back-to-back deals with the same deal details, in opposite buy/sell directions.
   • Customer deal (against the requesting customer)
   • Cover deal (with the rate service provider)

Repair Handling

4. If OBTR is unable to complete deal booking due to an issue, the transaction is moved to a repair queue for bank users to review and take corrective action to complete deal booking.

Status Notification to Calling System

5. OBTR notifies the external system of the outcome in both cases:
   • Successful booking
   • Booking failure (including errors/repair scenarios, as applicable)