Webhook Receivers
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
The process [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 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 (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). |
INTER | INITIAL | closed | Notify user. |
INTER | MIRROR | closed | Notify user. |
INTRA | INITIAL | closed | Notify user. |
INTRA | MIRROR | closed | Notify user. |
Legend:
- Conversion type INTER - “interbank transaction” - stands for
FX Transfers
- Conversion type INTRA - “intrabank transaction” - stands for
House Transfers
- Conversion scope INITIAL - “performed as part of the happy flow (
FX
andHouse Transfers
)” - Conversion scope MIRROR - “performed as part of the refund flow (
FX
andHouse Transfers
)”
Please Note
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 process [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 payment status
.
Sequence diagram
Webhook receiver functionality
- The webhook receiver captures the payment information from the Currencycloud webhook.
- The Mambu
transactionId
anddepositAccountId
are retrieved, based on the CurrencycloudpaymentId
. - The
payment status
is updated at the withdrawal level in Mambu.- If the status is
failed
orcompleted
, the transaction is searched for in thePayments State Diagrams
and 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 status
and sends a notification to the assigned user asking for manual adjustment of the transaction steps, if the payment is failed.
- If the status is
Please Note
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.