How do transactions differ from transfers and collections?
Transfers and collections are types of transactions that you can initiate through the API. They have dedicated endpoint resources to help you follow their detailed lifecycle. On the other hand, transactions allow you to follow the lifecycle of all transactions, including those not initiated through the API (incoming transactions, card transactions, etc). Since transfers and collections are a subset of transactions, some webhook events will be triggered simultaneously (for instance, transfer_confirmed
and transaction_confirmed
), and you can use either.
Is creating a beneficiary or mandate mandatory before initiating transactions?
Creating a beneficiary for transfers or a mandate for collections is not mandatory. When initiating a new transfer or collection, you will provide the counterpart data directly in the initiating endpoint, We will auto-create it, and you will be able to see it in the interface. For subsequent transfers/collections, you will continue to provide the counterpart data, and we will match it with any existing beneficiary/mandate in the interface.
How can I reconcile a return with its original transfer or collection?
The events transfer_returned
and collection_returned
received via webhook will inform you if a return occurred on either a transfer or a collection. The resource_id
in those events refers to the ID of the original transfer/collection. The return_transaction_id
field on those resources will reference the return transaction, which is a new transaction typically with the same amount and opposite direction compared to the original transaction. This new transaction will itself trigger a transaction_confirmed
webhook event. For such transactions, if you call get the transaction and check the source type, it will either be transfer_outgoing_return
or collection_outgoing_return
. The returned_collection_id
/returned_transfer_id
field will contain the ID of your original collection/transfer that has been returned.
How can I differentiate transaction types?
To differentiate transaction types, you can use the type contained in the source object.
What happens if my system is unavailable when Memo Bank sends webhooks?
We will retry each webhook event independently 8 times following an exponential backoff. The intervals between retries are: 3 min, 10 min, 30 min, 1 hour, 6 hours, 12 hours, 1 day, and 3 days. After that, we will stop retrying, but you will be able to manually trigger a retry through our interface.
When using the instant_if_available
strategy, will Memo Bank retry a failed instant transfer as a standard transfer?
No, we will not retry failed instant transfers as standard transfers. However, we recommend that you do so. If an instant transfer fails, retrying it or using a standard transfer is often the best course of action. instant_if_available
will only ensure that we process your transfer as standard if the counterparty bank does not support instant transfers.
What is the difference between failed and cancelled transaction statuses?
Your transaction will end up in a cancelled status when you choose to cancel it either through our API or our interface. In some cases, your transaction may also end up in a cancelled status due to internal processing reasons, but most of the time, for processing reasons, your transaction will end up in a failed status. Both statuses are definitive, and if you did not initiate the cancellation, you can consider them equivalent in your development.
Are webhooks triggered for transactions not initiated with the API?
Yes, they are. Webhooks are triggered regardless of the channel you use to initiate your transaction.
Can I retrieve the URL of the mandate request signature flow?
No, it is not possible at the moment. Currently, we only support sending the URL to your clients by email.
Is it possible to initiate a payment via API and have it validated by a human on the interface?
No, it is not possible. Our API is designed for automated, human-free transactions at scale.
How can I stay informed about the latest API updates?
We provide an RSS feed that you can subscribe to. It is available at this URL when you click the Get Updates
button at the top of the page.