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.documentDetails
in the eKYB process. However, starting January 1, 2024,stakeholderDetails.documentDetails
will 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.document
will continue to be optional in the eKYB process when asearchID
is provided, but they will be required fields whensearchID
is 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
issuanceMode
field has two new options:international_delivery_track
andinternational_delivery_track_sign
.
New Feature
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
rateCaptureTime
was added in the API response for creating a quote and fetching an existing quote. TherateCaptureTime
field contains the timestamp at which we obtained it from our rate service provider.