Inbound and Outbound 3rd Party UK Faster Payments​

We are pleased to announce that the UK Faster Payments payment method now supports 3rd party inbound and outbound domestic transfers for both Corporates and Consumers.

For GBP managed accounts connected to this service, you will receive a sort code and account number when upgrading the managed account. These details can be used for domestic payments in GBP. The payment reference that was previously required to make deposits will not be required when using this sort code and account number.

Please note: Managed accounts may be marked as inactive for a short period of time after opening, whilst the account details are assigned. Once assigned a webhook notification will be sent to you confirming that the account is now active. You should only initiate the upgrade account request once the account is marked active. Find more details on how to upgrade managed accounts in our guide.

If you would like to start using this payment method now, please contact us via the Support Portal so that we can enable it for you.

In due course all GBP managed accounts will be automatically upgraded.

Deposit Transactions - Additional Sender Information​

When depositing funds using the new UK Faster Payments payment method, the senderIban, senderName and senderReference fields will be included as part of the managed account deposit transaction.

All three fields are available when retrieving a managed account statement, as part of the entry.additionalFields, and when you are notified of a managed account deposit via the webhook. They are also displayed as part of the managed account activity within the portal.

These fields will be added to SEPA and SWIFT deposits soon.

Affected APIs:

• GET /managed_accounts/{id}/statement

Affected Webhooks:

• POST /managed_accounts/deposits/watch

Consumer place of birth - New Optional Field​

When onboarding a consumer identity you can optionally include the placeOfBirth field. If provided, this information is pre-filled for the user when they are submitting their information for KYC.

If the user hasn’t completed KYCm, you can also update the field via the Update Consumer API endpoint.

Affected APIs:

• POST /consumers
• PATCH /consumers

Physical Cards - New Optional second line for name on card​

The name on card for physical cards now supports 2 lines. You can optionally specify a second line via the nameOnCardLine2 field when upgrading a virtual card to a physical card. When provided, the second line will also be printed on the physical card itself.

Affected APIs:

• POST /managed_cards/\{id\}/physical
• POST /managed_cards/assign

Spend Rule - Allowed merchant countries​

You can now specify an allowed or blocked list of countries from where the user can make purchases. The card purchase country is determined from the merchant's registration country.

The allowed and blocked lists can be configured in the card profile level via the Multi portal or per card in the Multi API.

Affected APIs:

• GET /managed_cards/\{id\}/spend_rules
• PUT /managed_cards/\{id\}/spend_rules

Spend Rule - Single card purchases​

You can now specify the minimum and / or maximum amount of a single card purchase via the Multi API.

Card purchases that are below the minimum amount or above the maximum amount will be automatically declined. This control can be configured per card.

Affected APIs:

• GET /managed_cards/\{id\}/spend_rules
• PUT /managed_cards/\{id\}/spend_rules

Card purchase simulator - forex configuration​

You can now simulate card purchases that include a forex fee and / or a forex padding via the Multi portal. This option has been added to the Purchase by Card ID and Purchase by Card Number simulators.

Authorisation webhook - additional forex information​

The forexPadding field is now available as part of the card authorisation webhook. This field is included when the purchase currency is different from the card's currency and therefore forex is required.

Affected webhooks:

• POST /managed_cards/authorisations/watch

Service status announcements​

You can now view the status of our services and subscribe to receive service status updates. The same announcements are also visible in the Multi portal.

Card friendly names - Emojis Support​

Your customers can now include emojis in their card friendly names to further personalise their cards ✨

Updated the company registration number to optional​

You can now onboard sole traders who do not have a company registration number. The company.registrationNumber parameter can now be left empty.

Note, that for other company types, the registration number is still required to complete the KYB process.

Affected APIs:

• GET /corporates
• POST /corporates
• PATCH /corporates

New sender name information in the deposit webhook​

The account deposit webhook now includes new senderName field as part of the deposit information.

Affected webhooks:

• POST /managed_accounts/deposits/watch

New cancelled type for card authorisations​

Card authorisations are cancelled if an approve or reject decision is not received by the provider in the agreed time. This ensures that no authorisations are wrongly approved.

If a card authorisation is cancelled by the provider, you will receive a card authorisation webhook notification having the authorisationType field set as CANCELLED. Cancelled card authorisations are now included in the card statement API endpoint with their entry.transactionId.type being AUTHORISATION_CANCELLATION.

Affected webhooks:

• POST /managed_cards/authorisations/watch

Affected APIs:

• GET /managed_cards/\{id\}/statement

New Pending state for deposit, transfer and send transactions​

In most cases, transactions are executed instantly, however there are cases where a transaction needs to be temporarily paused. This may be due to different reasons, ranging from asynchronous processes to transaction monitoring.

If a deposit, transfer or send transaction is in a pending state, its transaction state will be marked as PENDING and will resume automatically as soon as all requirements are met.

Affected APIs:

• GET /transfers
• GET /transfers/\{id\}
• POST /transfers
• GET /sends
• GET /sends/\{id\}
• POST /sends

Additional transaction information in the managed account and managed card statement​

The following fields are now available in the the managed account and managed card statement:

• actualBalanceAfter
• actualBalanceAdjustment
• availableBalanceAfter
• availableBalanceAdjustment
• entryState

Instrument balances are represented using both an actual and an available balance. The actual balance shows how much funds actually reside on the instrument, while the available balance shows how much funds are available to be used. If there are no pending transactions on the instrument, the available and actual balance should be equal. Transaction entries returned in the statement APIs are reporting a balance change in one or both balances.

Note that the balanceAfter field is now deprecated in favour of the availableBalanceAfter.

The new transaction entryState field indicates whether a transaction has moved into a PENDING or COMPLETED state. When a transaction is in a PENDING state, this means that some fund movements have completed however additional fund movements are still pending. Once a transaction is moved to a COMPLETED state, this means that all expected fund movements are now complete.

Affected APIs:

• GET /managed_cards/\{id\}/statement
• GET /managed_accounts/\{id\}/statement

New check for mobile number​

The mobile number used by authorised users within the same corporate or consumer identity must be unique. If a mobile number is already being used by another user, the API will return an HTTP 409 - Conflict error with error code MOBILE_NOT_UNIQUE.

Detailed consumer due diligence status information​

You can now download the due diligence screening report of a consumer from the Multi Portal. In the report, you will find detailed information on the status of the due diligence process and any reasons for which the identity hasn't been approved yet.

This report will only be available if the identity has not completed due diligence.

New sender name field with deposit transactions​

In the deposit transaction details screen in the Multi portal, you can now see the sender of deposit transactions received on your customers' managed accounts.

More flexible end-customer send transaction fees​

Send transactions can transfer funds between cards and managed accounts. You can now charge a different fee, based on the source and destination instrument types involved in the transaction.

End-customer fees can be configured in the Multi portal.

More fine grained forex fee options​

When configuring your end-customer forex fees in the Multi portal, you can now choose from increments of 0.25%.

Please note that forex fees are attached to a card when it is being created, so if you change the fee afterwards, the new rate will only apply for newly created cards.

Additional due diligence failure details in webhooks​

A new rejectionComment field has been added in the consumer and corporate due diligence webhooks to include a detailed description as to why due diligence has been temporarily rejected. This information should be used together with the failureReason field to provide more information to the user.

Affected webhooks:

• POST /consumers/kyc/watch
• POST /corporates/kyb/watch
• POST /corporates/kyb/beneficiaries/watch

A fresh new look for our webhooks​

We have updated our webhook API documentation design style so that it is in line with the Multi API design style. Don't worry, nothing has changed with the webhooks themselves.

You can find the new webhook documentation here.