Integration Principles

This page describes the common integration behaviour for the FAST Transaction Interface, including expected HTTP responses, response body requirements, Store and Forward (SAF), batch processing, and retry behaviour.

These principles apply to all FAST message types unless otherwise stated.

Message Types

The FAST Transaction Interface supports the following message types:

Message Type	Description	Expected Client Response
FAST Auth	Real-time authorization request sent by Paymentology.	Return HTTP 200 OK and a response body containing the authorization decision.
FAST Settlement	Settlement notification sent by Paymentology. Delivered using the Store and Forward (SAF) mechanism.	Return HTTP 200 OK only when all settlement messages in the request have been successfully processed. No response body is expected.
FAST Advice	Advice message sent by Paymentology. Delivered using the Store and Forward (SAF) mechanism.	Return HTTP 200 OK or 201 Created and a response body containing the advice response.

Note

Response behaviour differs between FAST Auth, FAST Settlement, and FAST Advice messages. Refer to the sections below for the expected response for each message type.

HTTP Responses

Paymentology expects the client endpoint to return an HTTP response for every FAST request.

Message Type	Successful HTTP Response(s)	Response Body	Delivered via SAF
FAST Auth	200 OK	Required	No
FAST Settlement	200 OK	Not expected	Yes
FAST Advice	200 OK, 201 Created	Required	Yes

If a response other than the expected HTTP status code(s) is returned, or no response is received, Paymentology considers the request delivery unsuccessful.

For FAST Settlement and FAST Advice, unsuccessful deliveries are automatically retried using the Store and Forward (SAF) mechanism.

Response Body Requirements

Message Type	Response Body
FAST Auth	A response body is mandatory and must conform to the published FAST Auth response schema.
FAST Settlement	No response body is expected. Any response body returned is ignored by Paymentology.
FAST Advice	A response body is mandatory and must conform to the published FAST Advice response schema.

Store and Forward (SAF)

FAST Settlement and FAST Advice messages are delivered using Paymentology's Store and Forward (SAF) mechanism to provide reliable message delivery.

Paymentology determines whether a message has been successfully delivered based on the HTTP response returned by the client.

Message Type	Successful HTTP Response(s)
FAST Settlement	200 OK
FAST Advice	200 OK, 201 Created

If any other HTTP status code is returned, or no response is received, Paymentology considers the delivery unsuccessful and retries the request according to the configured retry policy.

Batch Processing (FAST Settlement)

Paymentology may send multiple settlement messages within a single FAST Settlement request.

The client should process all settlement messages contained within the request before returning an HTTP response.

The HTTP response represents the processing outcome of the entire request, not individual settlement messages.

Example

FAST Settlement Request

Settlement A
Settlement B
Settlement C

Partial Processing

Return HTTP 200 OK only when every settlement message within the request has been successfully processed.

For example:

FAST Settlement Request

Settlement A
Settlement B
Settlement C

Possible outcome:

✅ Settlement A processed successfully
❌ Settlement B failed
✅ Settlement C processed successfully

Since one settlement message failed, the client should return an HTTP status code other than 200 OK.

Paymentology will retry the entire FAST Settlement request through the Store and Forward (SAF) mechanism, including all settlement messages contained within the original request.

Important

Clients should implement idempotent processing, as settlement messages that have already been processed successfully may be delivered again following a retry.

Best Practices

Return the expected HTTP success response for each FAST message type.
Return HTTP 200 OK for FAST Settlement only when every settlement message within the request has been successfully processed.
Return HTTP 200 OK or 201 Created for FAST Advice together with a valid FAST Advice response body.
Return a valid FAST Auth response body for every FAST Auth request.
Do not return a response body for FAST Settlement requests.
Implement idempotent processing for FAST Settlement and FAST Advice messages, as the Store and Forward (SAF) mechanism may redeliver messages following a retry.