Skip to main content

Integrating with the RTGS.global API

Integration Model​

The integration follows an HTTP in, Events out pattern:

  • Messages are sent to the Gateway via HTTP endpoints.
  • Results are received asynchronously via Azure EventGrid subscriptions.

HTTP — Sending Messages​

To find your Gateway API URL:

  1. Open the Azure Portal and navigate to your managed application resource group.
  2. Filter resources by names starting with rtgs-ga.
  3. Copy the Application URL from the essentials section.

This URL is your HTTP endpoint for sending messages to the Gateway.

EventGrid — Receiving Messages​

To receive asynchronous responses:

  1. In the Azure Portal, locate the Event Grid Topic resource (name begins with rtgs-messaging-).
  2. Create at least one Event Grid Subscription.
  3. Follow Microsoft's standard subscription setup procedures.

Event Schema​

All events use CloudEvents v1.0 schema. See API and Event Messaging for the full message compatibility table.