Webhook Receivers

These two webhook receivers do not represent flows themselves, but are used by different flows to receive notifications from Currencycloud. Currencycloud will then either start a process or move a running process to the next step.

Conversions webhooks receiver

The [COMMON] CurrencyCloud WEBHOOK receiver for CONVERSIONS [Linked to CCy webhook] process is used in the integration only for the transactions that imply a conversion from one currency to another, as is the case for FX Transfers and House Transfers.

Conversions webhook receiver statuses

The scope of this process, is to update a conversion with one of the two statuses: trade_settled or closed. All intermediary statuses are ignored.

[PREFUND] FX transfers conversion statuses and actions

Conversion typeConversion scopeStatusActions
INTERINITIALtrade_settledContinue FX payments flow.
INTERMIRRORtrade_settledNo action as the refund flow was successfully executed.
INTRAINITIALtrade_settledContinue the house transfer flow.
INTRAMIRRORtrade_settledNo action as the refund flow was successfully executed.
INTERINITIALclosedNotify the user.
INTERMIRRORclosedNotify the user.
INTRAINITIALclosedNotify the user.
INTRAMIRRORclosedNotify the user.
  • INTER or interbank transaction stands for FX transfers.
  • INTRA or intrabank transaction stands for house transfers.
  • INITIAL is performed as part of the succesful flow for FX and house transfers.
  • MIRROR is performed as part of the refund flow FX and house transfers.

Conversion webhook details and payload examples can be found in the Currencycloud notifications documentation. Extended information related to pre-fund FX transfer and house transfer logic can be found in the dedicated articles.

Payments webhooks receiver

The [COMMON] Currencycloud WEBHOOK receiver for PAYMENTS [Linked to CCy webhook] process is used by the FX transfer and Local payments processes. The scope of this process is to update Mambu transactions with the Currencycloud payment status.

Payments webhook

Webhook receiver functionality

The webhook receiver captures the payment information from the Currencycloud webhook. The Mambu transactionId and depositAccountId are retrieved, based on the Currencycloud paymentId. The payment status is updated at the withdrawal level in Mambu: 1. If the status is failed or completed: the transaction is searched for in the Payments State Diagrams and the status is updated at the payment level in the state diagram. 2. If the payment is not found in the state diagrams, a backup mechanism updates the transaction in Mambu with the new payment status and sends a notification to the assigned user asking for manual adjustment of the transaction steps - if the payment has failed.

Transfer webhooks are also sent from Currencycloud to this webhook receiver, but they are ignored since the status for these transfers is not used by any flow.