These two webhook receivers do not represent flows themselves, but are used by different flows to receive notifications from Currencycloud which will either start a process or move a running process along to the next step.
Conversions webhooks receiver
[COMMON] CurrencyCloud WEBHOOK receiver for CONVERSIONS [Linked to CCy webhook] 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
Conversions webhook receiver statuses
The scope of this process, is to update a conversion with one of the two statuses:
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 (refund flow was successfully executed).|
|INTRA||INITIAL||trade_settled||Continue the house transfer flow.|
|INTRA||MIRROR||trade_settled||No action (refund flow was successfully executed).|
- Conversion type INTER - “interbank transaction” - stands for
- Conversion type INTRA - “intrabank transaction” - stands for
- Conversion scope INITIAL - “performed as part of the happy flow (
- Conversion scope MIRROR - “performed as part of the refund flow (
Conversion webhook details and payload examples can be found in the Currencycloud notifications documentation.
Payments webhooks receiver
[COMMON] Currencycloud WEBHOOK receiver for PAYMENTS [Linked to CCy webhook] is used by the
FX transfer and
Local payments processes. The scope of this process is to update Mambu transactions with the Currencycloud
Webhook receiver functionality
- The webhook receiver captures the payment information from the Currencycloud webhook.
- The Mambu
depositAccountIdare retrieved, based on the Currencycloud
payment statusis updated at the withdrawal level in Mambu.
- If the status is
completed, the transaction is searched for in the
Payments State Diagramsand the status is updated at the payment level in the MPO State Diagram.
- If the payment is not found in the state diagrams, a backup mechanism updates the transaction in Mambu with the new
payment statusand sends a notification to the assigned user asking for manual adjustment of the transaction steps, if the payment is failed.
- If the status is
Transfer webhooks are also sent from Currencycloud to this webhook receiver, but they are ignored since the status for these transfers is currently not used by any flow.