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 type | Conversion scope | Status | Actions |
|---|---|---|---|
INTER | INITIAL | trade_settled | Continue FX payments flow. |
INTER | MIRROR | trade_settled | No action as the refund flow was successfully executed. |
INTRA | INITIAL | trade_settled | Continue the house transfer flow. |
INTRA | MIRROR | trade_settled | No action as the refund flow was successfully executed. |
INTER | INITIAL | closed | Notify the user. |
INTER | MIRROR | closed | Notify the user. |
INTRA | INITIAL | closed | Notify the user. |
INTRA | MIRROR | closed | Notify the user. |
INTERor interbank transaction stands for FX transfers.INTRAor intrabank transaction stands for house transfers.INITIALis performed as part of the succesful flow for FX and house transfers.MIRRORis 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.
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.