October 24, 2023
- Core Platform
- Issuance and Cards
- Payouts and Payins
New Features
We have added several new features to the Nium portal in the sandbox environment, including global wallets view, reports for payout transactions, configuring webhook events, inviting new users to your sandbox, and transparency with chronometer in the transaction details. Read the announcement blog for more details.
API Breaking Changes
Document details are required when onboarding in EU
Nium must report the "documentNumber" associated with the individual stakeholder positions of corporate customers to regulatory authorities through various reports. Until now, clients were not obligated to provide
stakeholderDetails.documentDetailsin the eKYB process. However, starting January 1, 2024,stakeholderDetails.documentDetailswill become a mandatory field for both the eKYB and Manual KYB procedures when the position corresponds to UBO, TRUSTEE, or PARTNER.Additionally,
stakeholderDetails.kycMode, andstakeholderDetails.documentDetails.documentwill continue to be optional in the eKYB process when asearchIDis provided, but they will be required fields whensearchIDis not provided for the manual KYB flow.See EU Required Parameters and EU Required Documents for more details.
New Features
If you are using the delegated model, we have improved the settlement report file to offer more comprehensive information for transaction matching. The new settlement file includes additional fields and is formatted with the pipe symbol as a delimiter, making it simpler to parse and handle. We're delivering the updated V2 version of the file to the same SFTP location where V1 was previously shared. Clients can take advantage of this enhanced file to improve their settlement processing. Detailed information on the format of the file is available in the Client Settlement Report guide.
Enhancements
Ability to update the name on the card for corporate cards. We have enhanced the Update Card Details V2 API, which will allow customers or cardholders to update card data at the individual card level, including the name on the card.
We have included new delivery options for the EU & UK. In the Add Card V2 API, the
issuanceModefield has two new options:international_delivery_trackandinternational_delivery_track_sign.
New features
Introduced a new API to retrieve Account Ownership Certificate (AOC) for your customers. To download the account ownership certificate, you can call the Account Ownership Certificate API.
The Account Ownership certificate is a PDF generated by Nium to provide the details of the virtual account(s) assigned to the name of the underlying customer.
AOCs are usually required by online marketplaces or payment gateways for registration.
AOC documents can be used by your underlying customers to provide account details for collections across different payment platforms.
Additionally, AOCs are required for loan applications or when dealing with government agencies.
Enhancement
Added transparency about the timing of the interbank FX rate. To ensure that you know the exact time at which we obtained the last traded interbank FX rate being used in an FX quote, a new field called
rateCaptureTimewas added in the API response for creating a quote and fetching an existing quote. TherateCaptureTimefield contains the timestamp at which we obtained it from our rate service provider.