Core Platform

There are no changes for this time period.

Issuance and Cards

Enhancements

Apple SDK

Our Apple Pay SDK has been enhanced to display the client's name when adding a card to an Apple Wallet. This helps you better manage cards in your Apple Wallet.

• SDK Version: 2.0.2
• Run pod update or pod repo update to get the latest version.

If you have any questions about our Apple SDK, please contact Nium Support.

Card Webhook Update

The walletProvider field in the VTS Token webhook is now restricted to applePay and googlePay.

This corrects an issue where some responses returned APPLE or GOOGLE. For more information, see VTS Token.

Payouts and Payins

There are no changes for this time period.

Core Platform - Enhancements

Nium Portal - Redesigned Customer Balances Page

We've redesigned the Customer Balances page to enhance usability:

• Review, at a glance, what features are enabled for each currency. This change helps you better understand what capabilities are available when managing those funds.
• Create Virtual Accounts for Payin-enabled currencies. Non-developers can now create Virtual Accounts in Nium Portal without directly using Nium’s API.

For more details, see the Nium Portal - Customer Balances.

There are no changes for this time period.

There are no changes for this time period.

There are no changes for this time period.

There are no changes for this time period.

New Feature

Account Verification

We’ve released a new Account Verification request that helps you verify payee details while creating beneficiaries. This change helps you simplify your integration, removing the need for a separate integration dedicated to verifying account details.

For more information, see Account Verification.

Enhancements

Updates to the Fetch Supported Corridors V3 Request

We’ve made the following changes to the Fetch Supported Corridors V3 request:

• payoutMethodCategory query parameter: Helps you separate supported payout methods by corridor - for more information and a detailed breakdown, see the Nium playbook.
• The query parameters beneficiaryAccountType, customerType, and payoutMethod have been made enums.

For more information, see the Fetch Supported Corridors V3 request.

New isOffMarket Parameter

We’ve introduced a new isOffMarket field to help you understand when off-market fees get applied to Conversion and Quote requests.

• The isOffMarket field is returned in the response to the following requests:

  • Create Quote
  • Fetch Quote by ID
  • Create Conversion
  • Fetch Conversion By Id
• Please note that this field isn't returned unless off-market requests have been enabled by Nium.

For more information, see FX - Overview.

Enhancement

A new query parameter status has been released for the Virtual Account Details V2 request. With this new parameter, the active/inactive virtual accounts can be filtered by Clients.

There are no changes for this time period.

There are no changes for this time period.

New Feature

Reports are now available in Nium Portal. Reports enhance your financial management experience by providing detailed insights into your transactions. You can now track, analyze, and manage your financial activities with ease. For more information, see Reports.

Breaking API Changes

Starting October 1st, 2024, changes in Nium’s compliance policy will require additional documents and parameters to onboard corporate customers using the Onboard Corporate API. Please update your integration accordingly to avoid disruptions. If you have any questions, please contact your Nium account manager or Nium Support.

• Current State: These documents and parameters are optional.

• Future Requirement: From October 1st, 2024, these fields and parameters will be mandatory.

• Changes to Nium: If the required documents and parameters are not included, the API will return an error indicating the missing documents and/or parameters.

Changes to the Onboard Corporate API include:

• Device Information: IP address and device name is now required for all regions when onboarding corporate customers. See the deviceDetails object in our API Reference for more information about the changes in each country:

  • Australia (AU)
  • Canada (CA)
  • Europe (EU)
  • Hong Kong (HK)
  • Singapore (SG)
  • United Kingdom (UK)
  • United States (US)

• Europe (EU): Additional information and documents are now required for both eKYB and manual KYB when onboarding corporate customers in Europe (EU). For more details, see:

  • EU Required Documents
  • Stakeholder KYC
  • expectedAccountUsage

• Singapore (SG): Proof of Identity and Proof of address documents are now required for stakeholders for both eKYB and Manual KYB when onboarding corporate customers in Singapore (SG). For more information, see SG Onboarding.

There are no changes for this time period.

There are no changes for this time period.

There are no changes for this time period.

Enhancements

• Fetch Card Details V2: Fetching details using the Card Details V2 endpoint now returns the demographics object. The demographics object only gets returned if the card is assigned to an employee but issued within a corporate customer's wallet. For more information, see Card Details V2.
  
  Details that get returned in the demographics object include:

  • firstName
  • middleName
  • lastName
  • nameOnCard
  • email
  • mobile

New Features

• Direct Debit is now available for Singaporean (SG) customers. Direct Debit enables SG-based businesses to fund their Nium wallets using their Singaporean (SG) bank account in real-time.

  • The transaction type for Direct Debit transactions is WALLET_CREDIT_MODE_DIRECT_DEBIT.
  • Reach out to your Nium account manager for details on how to activate Direct Debit.
  • For more information, see Direct Debit SG.

Enhancements

• Maximum limit for INR Proxy (UPI) transactions has been increased to INR 200,000 from INR 100,000. For more information, see the Nium - India Playbook.

Enhancements

• We’ve introduced three new reasons you can include when permanently blocking a customer:

  • UNRESPONSIVE_CUSTOMER
  • DORMANCY
  • OTHER

• Moving forward, when PERMANENT_BLOCK is used, the customer's account will be considered closed, and they can no longer process any further activity.

• Applications rejected due to high risk or non-compliance will now be blocked from being resubmitted. Previously, such applications could be resubmitted but were rejected by our compliance team after review. With this change, applications that have been previously rejected will automatically be rejected without any wait.

  • Resubmission is still allowed for reasons unrelated to compliance, such as incomplete applications, typos, or incorrect addresses.
  • For individual customers, see Individual Customer Onboarding - Overview.
  • For corporate customers, see Corporate Customer Onboarding - Overview.

Enhancements

• We’ve released two new webhook events to help you manage cards:

  • Card Details Updated: This event is triggered to notify the client or cardholder when any card details are updated. For more details, see Card Details Updated.
  • Card Expiry Alert: This event is triggered when a card is approaching its expiration date. For more details, see Card Expiry Alert.

There are no changes for this time period.

Enhancements

• Our eKYC Onboarding APIs are now available for individual customers in Canada. For more details, see CA onboarding.

• Our OpenAPI spec is now available on GitHub. You can download and review our OpenAPI spec to help you build your integration with Nium. For more details, see our Nium OpenAPI repo.

• We've added ▶ Run in Postman buttons to several guides. These buttons give you quick access to our Postman collection and enable you to see how requests run in real-time. For an example, see Individual Customer Onboarding.

There are no changes for this time period.

Enhancement

• We've added additional fields to the remitter object used in the Transfer Money request to provide more details about the payout sender. Fields added include:

  • idExpiryDate
  • idIssueDate
  • originatingFICity
  • originatingFICountry

  For more details, see Transfer Money.

New Features

• Clients can now manually execute FX conversions. With this change, you're given greater control and flexibility over how funds get converted in customer wallets and the associated settlement timeframes.

  • Pass the new ExecutionType field when making requests to the /Quote API to indicate a manual scheduled FX conversion. This field defaults to at_conversion_time if nothing is passed.

    • FX conversions with the field ExecutionType set to at_conversion_time settle at standard time, 5 PM local time.

  • Manual scheduled FX conversions must be executed using the /Execute endpoint (within the ExpiryTime) to transfer funds from the source currency to the destination currency within the wallet.

    • New fields:

      • ExecutionType: Set to at_conversion_time for timed conversions and manual for manual FX conversions.
      • ExpiryTime: This is a timestamp that indicates when the FX conversion expires. Manual conversions must be executed before this time.

  • We've also updated the following APIs:

    • Create Quote
    • Fetch Quote by ID
    • Create Conversion
    • Fetch Conversion By ID

Enhancements

• We've added a new compliancestatus query parameter to the Transactions endpoint. For more information, see:

  • Client Transactions
  • Customer Wallet Transactions

• Our manual KYB Onboarding APIs are now available for corporate customers in Canada. For more details, see CA Onboarding.

There are no changes for this time period.

Enhancements

• We've released a new version of our Fetch Supported Corridors API. This new version provides greater details about the corridor being used. Changes include:

  • Adding a mandatoryDataRequirements and supportingDocuments field.
  • Adding specifics around the transaction's limitations and turnaround time.

  For more information, see Fetch Supported Corridors V3.

• We've added the following query parameters to the Beneficiary List V2 endpoint:

  • beneficiaryName
  • beneficiaryAccountNumber
  • destinationCurrency
  • payoutMethod

Deprecation Notices

• We'll be deprecating Fetch Supported Corridors V2 within the next six months. As we prepare to do so, we'll surface more details. If you have any questions, reach out to the Nium Support team at any time.

Enhancements

We've added a new complianceStatus query parameter to the following endpoints:

• Transactions
• Client Transactions

Enhancements

You can now use PGP keys (also called RSA security) to transmit sensitive data.

For more details, see PGP Prerequisites.

API Breaking Changes

• We've removed the BEN enum from the payout#swiftFeeType field in the Transfer Money request.