Documentation for a newer release is available. View Latest

Setting up the Sending Application

The 'sending application' is the one sending requests to, and retrieving responses from, your payment adjustment application. To send requests to, and retrieve responses from, your payment adjustment application, you can wire in Send and Receive connectors for your chosen transport. The connectors can be wired in as described on this page.

The connectors should be configured above the default configuration by consulting the Connector documentation.

Kafka

To communicate via Kafka, you will need to bring the following dependency into your 'sending application'.

<dependency>
    <groupId>com.iconsolutions.ipf.payments.adjustment</groupId>
    <artifactId>payment-adjustment-client-connector-kafka</artifactId>
</dependency>

This brings in a SendConnector and a ReceiveConnector with default configuration, as shown below. In addition to the below defaults, they’ll also have all the standard Kafka Connector default configurations. To customise the configuration, please consult the Connector documentation.

Property Grouping: ipf.payment-adjustment.request.kafka.producer

Key Description Default Value

ipf.payment-adjustment.request.kafka.producer.kafka-clients.client.id

"client-request-paym-adjustment"

ipf.payment-adjustment.request.kafka.producer.restart-settings.max-backoff

"5s"

ipf.payment-adjustment.request.kafka.producer.restart-settings.max-restarts

5

ipf.payment-adjustment.request.kafka.producer.restart-settings.max-restarts-within

"10m"

ipf.payment-adjustment.request.kafka.producer.restart-settings.min-backoff

"1s"

ipf.payment-adjustment.request.kafka.producer.restart-settings.random-factor

0.25

ipf.payment-adjustment.request.kafka.producer.topic

"PAYMENT_CANCELLATION_REQUEST"

Property Grouping: ipf.payment-adjustment.response.kafka.consumer

Key Description Default Value

ipf.payment-adjustment.response.kafka.consumer.kafka-clients.auto.offset.reset

"earliest"

ipf.payment-adjustment.response.kafka.consumer.kafka-clients.group.id

"client-response-paym-adjustment"

ipf.payment-adjustment.response.kafka.consumer.restart-settings.max-backoff

"5s"

ipf.payment-adjustment.response.kafka.consumer.restart-settings.max-restarts

5

ipf.payment-adjustment.response.kafka.consumer.restart-settings.max-restarts-within

"10m"

ipf.payment-adjustment.response.kafka.consumer.restart-settings.min-backoff

"1s"

ipf.payment-adjustment.response.kafka.consumer.restart-settings.random-factor

0.25

ipf.payment-adjustment.response.kafka.consumer.topic

"PAYMENT_ADJUSTMENT_RESPONSE"

JMS

To communicate via JMS, you will need to bring the following dependency into your 'sending application'.

<dependency>
    <groupId>com.iconsolutions.ipf.payments.adjustment</groupId>
    <artifactId>payment-adjustment-client-connector-jms</artifactId>
</dependency>

This brings in a SendConnector and a ReceiveConnector with default configuration, as shown below. In addition to the below defaults, they’ll also have all the standard JMS Connector default configurations. To customise the configuration, please consult the Connector documentation.

Property Grouping: ipf.payment-adjustment.client-connector.jms

Key Description Default Value

ipf.payment-adjustment.client-connector.jms.broker.url

"tcp://localhost:61616"

ipf.payment-adjustment.client-connector.jms.consumer-window-size

0

ipf.payment-adjustment.client-connector.jms.failover-timeout

5000

ipf.payment-adjustment.client-connector.jms.receive-timeout

5000

ipf.payment-adjustment.client-connector.jms.request.queue

Queues

"PaymentCancellationRequestQueue"

ipf.payment-adjustment.client-connector.jms.response.queue

"PaymentAdjustmentResponseQueue"

ipf.payment-adjustment.client-connector.jms.session-cache-size

25

HTTP

If you’d prefer to use your own client implementation to connect via HTTP then please refer to the Payment Adjustment OpenAPI Specification page.

To communicate via HTTP, you can bring the following dependency into your 'sending application'.

<dependency>
    <groupId>com.iconsolutions.ipf.payments.adjustment</groupId>
    <artifactId>payment-adjustment-client-connector-http</artifactId>
</dependency>

This dependency brings in a HTTP RequestReplySendConnector with default configuration, as shown below. In addition to the below defaults, they’ll also have all the standard HTTP Connector default configurations. To customise the configuration, please consult the Connector documentation.

Property Grouping: ipf.payment-adjustment.request.http.client

Key Description Default Value

ipf.payment-adjustment.request.http.client.endpoint-url

"/api/v1/payment-adjustment/cancel"

ipf.payment-adjustment.request.http.client.host

"localhost"

ipf.payment-adjustment.request.http.client.port

8080