May 23, 2023
-
New features
-
Link a corporate customer to an individual customer is a new feature for Spend Management and Payroll Management use cases. You can now link an individual customer, or employee, to their corporate customer and create that hierarchy in the system.
Note: For details on how to link a corporate customer to an individual customer or the Spend and Payroll Management feature, refer to the Platform tab.
-
Spend Management: assigns a card to an employee linked to a corporate account. You can issue cards using the Add Card V2 API to provide the customer details as mentioned below:
-
customerHashId
: thecustomerHashId
of the corporate customer -
walletHashId
: the uniquewalletHashId
of the corporate customer -
childCustomerHashId
: thecustomerHashId
of the individual customer
The card is issued to a corporate customer and is linked to an individual customer.
You can fetch the
childCustomerHashId
with the Card Details V2 and Card List APIs. The query parameters are enhanced to include the clientHashId, customerHashId, walletHashId, and childCustomerHashId to help filter the results. -
-
Payroll Management: assigns a card to an employee for their own account. You can issue cards using the Add Card V2 API to provide the customer details as mentioned below:
-
customerHashId
: thecustomerHashId
of the corporate customer -
walletHashId
: the uniquewalletHashId
of the corporate customer -
childCustomerHashId
:NULL
The card is issued to an individual customer.
-
-
-
Card List V2 API retrieves a list of all cards issued to a wallet using the
walletHashId
and thecustomerHashId
path parameters.- The API structure mirrors the structure of all other Card V2 APIs with logical tags.
- The API shows the delivery address on file, the address where the card is delivered, and its embossing details.
- Card List V1 API is deprecated and becomes unsupported on December 31, 2023.
-
A transaction is declined if the Know Your Customer (KYC) verification process is in the pending status. This change is in accordance with compliance regulations. All cards associated with the customer and their wallet are also temporarily blocked until the status changes to verified.
Enhancements
- Search and filter cards in the client portal using a new Search and Filter feature entering a card number, a card hash ID, and a card proxy number, on the customer details screen. The functions help find a card among multiple ones attached to a wallet.
- Card Details V1 and V2, and Card List V1 and V2 APIs provide device details for Mastercard. Before, device details were only available for Visa cards.
-
-
New features
-
Spend and Payroll management:
-
Link a corporate customer to an individual customer is a new feature for Spend Management and Payroll Management use cases. You can now link an individual customer, or employee, to their corporate customer and create that hierarchy in the system. Only an individual customer can be linked to a corporate customer. The opposite isn’t true.
To establish a connection or relationship between the individual customer and the corporate customer, you need to configure the relationship with the
childMustHaveParent
parameter set totrue
. If this flag isfalse
, you have the option to establish the connection, but the hierarchy is not enforced by the system.-
Spend Management clients need to be configured with the
billingAddressAsCorporate
parameter set totrue
. This parameter allows the billing address of an Individual customer to be the same as the business address of a corporate customer. -
Payroll Management clients need to be configured with the
billingAddressAsCorporate
parameter set tofalse
.
To setup the hierarchy, you need to onboard the corporate customer first and then onboard the individual customer using the Unified Add Customer API. The fields below have been impacted:
-
parentCustomerHashId
: A new required parameter has been added if thechildMustHaveParent
flag is set totrue
. -
kycMode
: accepts MANUAL_KYC value if thebillingAddressAsCorporate
parameter is set totrue
. -
billingAddress
: details are optional if thebillingAddressAsCorporate
parameter is set totrue
.
You can fetch the parentCustomerHashId for an individual customer with the following enhanced APIs:
-
Customer List
V3 API: allows all individual customers to have the
parentCustomerHashId
parameter value available. You can fetch all the Individual customers linked to a corporate customer by providing theparentCustomerHashId
parameter as a part of the query parameter. -
Customer
Details
V2 API: the
parentCustomerHashId
parameter, in the individual customer details section, provides thecustomerHashId
of a corporate customer to which the individual customer is linked.
-
Spend Management clients need to be configured with the
-
Transaction management is enhanced with the update of the following APIs to include the transactions that individual customers make on the cards issued to corporate accounts:
-
Transactions API: The
childCustomerHashId
parameter is added for all the transactions. The value includes thecustomerHashId
of the individual customer for the applicable transactions. ThechildCustomerHashId
can be used as a query parameter in this API. -
Client Transactions API: The childCustomerHashId parameter is added
for all
the transactions. The value includes the customerHashIdof the individual customer
for the
applicable
transactions. The
childCustomerHashId
can be used as a query parameter in this API.
-
Transactions API: The
-
-
Electronic document verification, or
E_DOC_VERIFY
, is now available as an option inkycMode
for Know Your Customer (KYC) applicants in all regions. Corporate customers in Australia (AU), Singapore (SG), and the United States (US) previously completed the applicant KYC verification process viaMANUAL_KYC
, which delays the approval process. UsingE_DOC_VERIFY
, customers can now complete the KYC verification process for non-resident applicants following the redirect URL of Nium's KYC vendor and uploading documents on the vendors' UI resulting in real-time approvals.E_DOC_VERIFY
is also available for Electronic Know Your Business (eKYB) and manual KYB.E_DOC_VERIFY
is also available for European Union (EU) and United Kingdom (UK) applicants.Enable
E_DOC_VERIFY
by passing thebusinessDetails.applicantDetails.kycMode=E_DOC_VERIFY
object in the Onboard Corporate Customer API. Refer to Region-specific KYB requirements to see the available applicant and stakeholder KYC modes. Refer to the applicant KYC information on the following pages to learn how to integrate: AU, SG, US -
Customer account statement generates a statement that gives a list of all transactions your customer makes on the platform, including deposits, withdrawals, spending, fees, payments, and refunds. You can give your customers an account statement periodically or based on their specific requests to help them keep the information for their records or to reconcile their transactions. You can now generate an account statement for your customers via the Account Statement API as a PDF or a CSV document. Contact your Nium representative to use this feature.
Enhancements
-
Customer List V3 API features a new query parameter, named
customerType
, so you can fetch your customer list based on your customer type. The accepted values areINDIVIDUAL
orCORPORATE
. -
Unified Add Customer API makes the new customer onboarding delivery address parameters listed below optional. You can now choose to use the fields but they’re not required.
deliveryAddress
deliveryAddress2
deliveryCity
deliveryCountry
deliveryLandmark
deliveryState
deliveryZipCode
-
Spend and Payroll management:
May 9, 2023
-
New features
Introduced the Direct Debit capability on Nium's payments network for UK and EU customers. The capability provides convenience to UK-based and EU-based businesses to fund from their UK and EU bank account respectively into their Nium-issued wallets using Direct Debit. To support this feature, new APIs have been added and the existing APIs have been modified as mentioned below. The transaction type for this payment method in Nium's system is
WALLET_CREDIT_MODE_DIRECT_DEBIT
. Contact your Nium representative to activate this feature.Refer to the Direct Debit user guide for more details on this feature.
-
addFundingInstrument
API — Links the customer’s bank account to their Nium wallet. Additional data elements have been added to receive bank account details in setting up Direct Debit for UK and EU customers. -
confirmFundingInstrument
API — Receives the one-time password (OTP) entered by the customer for validation by Nium against the OTP generated by Nium before setting up a Direct Debit mandate. This is a new API. -
getFundingInstrumentDetail
API — Provides the details of the account that's linked. -
getFundingInstrumentList
API — Provides the list of accounts that are linked. -
fundWallet
API — Initiates the payment instruction to pull the funds.
Enhancements
Introduced the new field
statementNarrative
in the Fund Wallet API to allow you to pass information that you would like to display in the payer's account statement for every debit transaction done via Direct Debit. The information that you can pass has a maximum length of 10 characters for the US and UK and a maximum length of 140 characters for EU.API breaking changes
Introduced two new fields in both V1 and V2 of beneficiary APIs. These fields are required for making a local payout to a business in South Africa with South African rand (ZAR) currency.
The updated APIs that include the new fields are
addBeneficiary
,updateBeneficiary
,beneficiaryDetail
, andbeneficiaryList
.-
beneficiaryContactName
(beneficiary_contact_name
in v1) - This field requires the name of the contact person of the business. -
beneficiaryEntityType
(beneficiary_entity_type
in v1) - This field requires a beneficiary entity type and needs to be one of the following lowercase values:
[sole_propriatorship
,partnership
,privately_owned_company
,publicly_owned_company
,government_owned_company
,go
,financial_institution
]
-
-
New features
In the previous year, we implemented restrictions on card issuance to countries that were approved in the Payment Instruction File (PIF) submitted to the card schemes. However, following additional feedback from the schemes, we have updated our approach and now restrict card issuance based on card type: physical or virtual.
With this new approach, you have the flexibility to configure the countries where you want to issue virtual cards (pending approval from the schemes), even if physical card issuance to those countries is not permitted.
For example, VISA has granted approval for virtual card issuance in Vietnam for a client based in Singapore, but physical cards are still prohibited.
Enhancements
In the previous release notes, we announced that
ADD_ON
type additional cards will no longer be supported from Sep 30th, 2023. With this release, ADD_ON cards will not be renewable via the Card Renewal API.API breaking changes
Removed the
maskedCardNumber
field from the response object of Add Card API v2. If needed, you can use Card Details API (v1 or v2) to get themaskedCardNumber
field.The maskedCardNumber field still exists in Add Card API v1.
Deprecation notices
Add-on Cards are no longer issued after September 30, 2023.-
Add Card API v1 will return an error if the
card being created is an 'Add-On’ card after
Sep 30th, 2023. Clients must make the change to either switch to Add Card API v2
or ensure that
cardIssuanceAction
field in Add Card API v1 is passed as 'NEW' to indicate creation of the primary card. - All existing Add-On cards are going to continue to work.
Refer to the Deprecated APIs page for the complete list.
-
Add Card API v1 will return an error if the
card being created is an 'Add-On’ card after
Sep 30th, 2023. Clients must make the change to either switch to Add Card API v2
or ensure that
-
New features
-
Fetch Corporate Constants API
Fetch Corporate Constants API is now available for you to look up the enum values related to the onboarding of your corporate customers. This API returns acceptable values of various fields that need to be passed via the Onboard Corporate Customer API.
There are many fields in Onboard Corporate Customer API which are of type enum and some of these fields have values that change often, such as
intendedUseOfAccount
andIndustrySector
. Integrating this API helps you handle these changes without the need of any further development on your end when values are updated.Keeping enum values updated is beneficial to customers as it improves the approval rates and reduces the approval turnaround time.
You need to integrate the Fetch Corporate Constants API and display the output to customers as a dropdown list while they complete your onboarding form. Use this API for all possible fields such as
businessType
,documentType
,annualTurnover
,intendedUseOfAccount
, etc. For further details, see the Fetch Corporate Constants user guide.
-
Regenerate KYC URL API for Onboarding Corporate Customers
The KYC URL returned in the response of Onboard Corporate Customer has an expiration time; and once expired, the link cannot be used to complete the applicant KYC.
Use the Regenerate KYC URL API to generate a new KYC URL with a renewed expiration time.
This API can be used for all regions if
applicantDetails.kycMode='E_DOC_VERIFY'
and in Singapore for bothE_DOC_VERIFY
andE_KYC
.
API breaking changes
Introducing a new validation on
businessRegistrationNumber
. The change is applicable to Nium clients in all geographies that are onboarding corporate customers in the US. Going forward, you are expected to send only 9 digit numerals in this field. Any other format will result in a validation error.The change is effective July 1, 2023.
Deprecation notices
Starting Sep 1, 2023 many of the enum values for the below listed fields will be removed or updated to support a newer version of our risk scoring model. Make use of the new Fetch Corporate Constants API to get the latest values that are supported for these fields.
Going forward integrate this API instead of hardcoding the new enum values for the associated fields.
Once your integration is completed, please reach out to Nium support to get your template configured for the latest risk model.
A few values are deprecated in the following fields of the Onboard Corporate Customer API:
- riskAssessmentInfo.industrySector
- riskAssessmentInfo.annualTurnover
- riskAssessmentInfo.intendedUseOfAccount
- riskAssessmentInfo.totalEmployees
Refer to the Deprecated APIs page for the complete list.
-
Apr 25, 2023
-
New features
-
Updated Fetch Remittance Life Cycle Status API with additional remittance statuses in its response. The new statuses provide granular information about each state of the transaction. The new statuses are:
-
INITIATED
— This status indicates that the transaction is accepted for processing. -
IN_PROGRESS
— This status indicates that the transaction is undergoing compliance review. -
RFI_REQUESTED
— This status indicates that Nium's compliance has raised a request for information (RFI). -
RFI_RESPONDED
— This status indicates that the customer has responded to the RFI. -
COMPLIANCE_COMPLETED
— This status indicates that Nium’s compliance has completed its review and that the transaction is going to be sent to the beneficiary’s bank. -
REJECTED
— This status indicates that the transaction is rejected due to compliance reasons. -
SCHEDULED
— This status indicates that the transaction is scheduled and is going to be processed on the set date.
statusDetails
field of this API. -
Added the Saudi riyal (
SAR
) currency for the Payin use case of collections and funding through an international wire transfer.
-
-
Enhancements
The response body of the Card Transaction Reversal webhook event type is updated to include the notification of additional transaction reversal scenarios. We now support transaction aging scenarios in addition to the merchant reversals.
-
New features
Electronic Know Your Business (eKYB) identification processs for onboarding US corporate customersThe eKYB check is now available for onboarding US corporate customers for clients in all countries where Nium operates. Using eKYB, corporate customers can get approved soon after submitting their application. Applicants aren't required to upload documents, making this an automated process. See the US Corporate Customer Onboarding guide for more information about the implementation instructions of the eKYB process. Contact Nium customer support to get your template configured for eKYB to use this feature.
Enhancements
Updates to the Customer List report that can be downloaded from the UI portal
-
The following fields are added to the report:
- Billing Country
- Case Id
- Client Hash Id
- Client Id
- Client Name
- Compliance Region
- Registered Date
- Segment
- Wallet Compliance Level
-
The following fields are removed from the report:
- Compliance Profile
- Designation
- KYC Status
- Preferred Name
API breaking changes
We've introduced two additional required fields for onboarding corporate customers in the US.businessDetails.applicantDetails.additionalInfo.applicantDeclaration
businessDetails.description
The changes are effective July 1, 2023. Clients are required to collect a declaration from the applicant during the time of corporate customer onboarding for the eKYB and manual KYB processes. This update only applies to corporate customers in the US. Clients are required to show the following text to the applicant and collect a click-to-accept agreement for the declaration.
"I certify that I am the authorized representative of the customer and all information provided and documents submitted are complete and correct. I have read and accept the Nium Terms and Conditions."
After the applicant accepts the declaration, they send a
Yes
value for the below field in the Onboard Corporate Customer API.businessDetails.applicantDetails.additionalInfo.applicantDeclaration
-
The following fields are added to the report: