Skip to main content

Creating and Managing Cards

Creating a cardโ€‹

You can create and load a single card on the _Create Card _ page.
Before creating any cards, ensure your relevant funding accounts have enough funds to cover card loading.

  1. Select _ Cards > Create Card > Single_
    The Create Card page is displayed.
  2. Complete the following fields:
    1. Select the Card Type: This determines card features (for example, the card brand).
    2. Select the Currency: This defines the currency for the card youโ€™re creating.
    3. Enter the Amount: This defines the amount of money to be loaded onto a card after its created

๐Ÿ“˜ NOTE

The amount of money that you can load onto a card during card creation depends on the limits set for your user group by your administrator). Please contact your administrator if you encounter loading limitations.

๐Ÿ“˜ NOTE

You can select the Forex calculator link to estimate the required load amounts based on current Forex conversion rates.

iv. Select the Funding Account: This identifies the funding account from the initial load amount (if any), and any applicable fees will be taken from.

๐Ÿ“˜ NOTE

Credit is a custom feature. Please contact your Client Delivery Specialist if you want to apply for credit.

v. Clearance Date: When any remaining card funds are transferred back to your Funding Account, the card will be automatically deleted. The card will remain valid until 23:59:59 GMT on the given day. We recommend clearing a card within a few days after it is created. This will reduce the risk of fraud.

  1. Optionally, you can schedule to load a card in the future by selecting the Scheduled Loads [+] link. With the scheduled load feature, you can delay the loading of funds onto a card until a date and time of your choice. This is useful when you need a card but want to pay later. For example, when you book a hotel room for your client but pay for the room when the client arrives. Using scheduled loads can help you unlock valuable working capital. Since funds are not available on the card until the date and time you chose, scheduled loads reduce your fraud exposure.

a. Enter the Initial Load Amount: This is the amount loaded when the card is created. (This is the same as the value in the Amount field above).
b. Enter a Scheduled Load Amount and select the calendar icon to choose the Load Date.
You can schedule a maximum of three loads on a single card. You can delete loads by selecting the [x] icon or leaving them blank.

If, during card creation, you choose a Single Load Card Type, you can only load your card once, either at the same time you create the card or in a single scheduled load. An error will be reported if you try to load it more than once. This feature is typically used by customers who want to maintain tight control over card usage.

  1. Optionally, you can add details for the requested card by selecting the Additional Details [+] link. You can use the External ID to identify the card uniquely. You can also use Additional Details to add custom data to the card - for example, a booking reference number or department name. You can enter a maximum of 20 custom detail entries. By default, five entries are displayed. If your deployment has a configuration to allow Dual Name on the card, you can use Card User to define it โ€“ for example, Traveller Name.

a. Select the _Add Additional Details _[+] link if you need more entries.
b. If you do not need entries, you can delete them or ignore them and leave them blank. To delete, select the [x] icon to the right of the row of fields.

๐Ÿ“˜ NOTE

Your deployment may have additional detail entries configured by default. You cannot change the name of a mandatory field. You cannot delete a mandatory field. You must provide a value of the mandatory field.

  1. Select the _Create _ button to create the card.
    The card is created, and the Card Details page is displayed.

  1. Select the _Download _ button below the card image to save card images.
  2. Select the _Print _ button below the card image to print card images.
  3. Select the _ E-mail_ button to share card images and details via email.
    1. Specify details on the_ Email Card Image_ page. You can add a custom message or list (if templates are available in your installation) and select a predefined template from the drop-down.

ii. Select the Send _button on the _Email Card Image page to send the email. The recipient can receive a link and view card images and details.

iii. To view your emails' status, see the Details page's _Email History _ section.
This section contains a log entry for every link sent by email for this card. The link expires automatically when the card is deleted, when the link has been opened three times, or when a new link is sent by email for this card (only one link can be active at a time for one card). The recipient views the card image or details until a link is expired. Select the [X] icon in the Actions column to manually set a link to expire.

  1. To export card information to a file, select the Export Card Request Data link in the bottom right section of the page. (You can select the Close\ _button in the confirmation window to close it. The export process will not be aborted.)
    When the file generation process is complete, the _Export Card Request Data
    link will be replaced by a_ Download File_ link. Select to download.
  2. To change additional details or scheduled loads for a card, enter new information in the Additional Details section and the Scheduled Loads section and select the Save Changes button.

Creating a batch of cards via Fileโ€‹

Using the predefined file, you can create a batch of new cards and load them from the Create Cards page.
Before you do, ensure your relevant funding accounts have enough money to cover the card load amount. For more information, see Managing funding accounts.

  1. Select_ Cards > Create Card > Batch_
    The Create Cards page is displayed.
  2. Enter a unique Batch Reference: The batch reference uniquely identifies a batch and can be used later to track the status of this request.
  3. _Download _ the Sample file from this page.
  4. _Upload _ the file using the predefined structure from the Sample file. Fill in all the mandatory fields and use the optional ones for the Virtual Card details. The system accepts excel files in CSV UTF-8, UTF-8 BOM, UTF-16, UTF-16 BOM. Note: Custom Filed Name field accepts only Latin letters

๐Ÿ“˜ NOTE

The amount of money that you can load onto a card during card creation depends on the limits set for your user group by your administrator. Please contact your administrator if you encounter loading limitations.

๐Ÿ“˜ NOTE

Remove the instructions and example from the Sample file and keep only the Header of the file presented in the row 1.

  1. Select the _Create _ button to start the card creation process.
  2. The system will make preliminary validations at this action and will either proceed with processing the file or return the error log. The details of the errors detected from the file processed will be available in the file downloaded from the _Download _ error log.

  1. Correct the file containing input parameters for the cards created in bulk and re-submit the same file again.
  2. Once the file passes the validations, the create cards in bulk process starts.
  3. A progress bar will show the creation status.
    The Request Completed message indicates that all cards of a specific type have been created successfully and card details are ready to be reviewed.
    The _Request Completed with Failures message _ indicates that some cards could not be created. There are various reasons this can occur. For example, you do not have enough money in your funding account to load the cards. A value in the _Unfulfilled Cards _ column shows how cards were not generated.
  4. To view card information for a selected batch in the request, choose the Download Card Details link in the bottom right section of the page.
    The Batch Card Create Details file displays the details of all created cards.

๐Ÿ“˜ NOTE

The input file for Create cards in Batch via File should be in CSV file format, following the header structure from the sample file. Supported encodings for the CSV file are: UTF-8, UTF-8 BOM, UTF-16. UTF-16 BOM.

Loading a cardโ€‹

When you load your card(s), you can load cards at the same time you create them or later. If you have multi-load cards enabled, you can also load cards repeatedly whenever suits your needs.
Before loading a card, ensure your funding accounts have enough money to cover your load amounts. For more information, see Managing funding accounts.

  1. Go to the Load Card page:
    • Select Cards > Load Card > Single, select the search method by selecting the appropriate radio button (By Card Reference, By Card Name, or By Card Number), enter the search criteria in the input field and select the _Search _ button.

  • Select Cards > Manage Cards, select the โ‹ฎ icon in the row that represents an active card, and choose_ Load Card._

Card details (including card images) are displayed on the _Load Card _ page.

  1. Enter the load details:
    1. Select a value in the _ Load From_ field: This field represents the funding account you will load the card from. (The funding account must be used to be visible in the drop-down list.)
    2. Enter the Amount: This field represents the amount of money you can add to a card. (The amount must be within the allowed limits of your account.)

๐Ÿ“˜ NOTE

The currency is displayed next to the Amount field. If this currency is different than the source currency or the destination currency, Forex fees may apply. Select the Forex calculator link to estimate your load amounts based on current Forex conversion rates.

  1. Select the_ Load _ button to initiate the card funding process.
    The card is loaded, and the details are displayed on the Load Complete page.

๐Ÿ“˜ NOTE

When you load a card for the first-time using credit funds, that card is linked to that particular credit funding account. You cannot load this card from a different credit funding account in the future.

Loading a batch of cardsโ€‹

As with cards created individually, you can load a batch of cards when you create them or later. If you have multi-load cards enabled, you can also load a batch of cards repeatedly whenever it suits your needs.
Before loading a batch of cards, ensure your funding accounts have enough money to cover your load amounts. For more information, see Managing funding accounts.

  1. Select Cards > Load Card > Batch
    The Load Cards page is displayed.
  2. Search for cards that are to be loaded with funds. You can use the following search criteria:
    1. Enter the Creation Date range (From/To): These fields represented the dates when cards were created.
    2. Select the _ Card Currency: _ This field represents the currency of the cards you want to load.
    3. Select the _Card Type: _ This field represents the name of the card type used to create the cards.
    4. Enter the Available Balance range (From/To): The cards you want to load should have their available balance in the given field (values are represented in the selected Card Currency).
    5. Select the Card Brand: _This field represents the card brand you want to load.
      If you cannot find the cards you need to load using basic search, choose the _Advanced Search _ link for additional search options. If you need more entries to search for, select the
      Add Additional Details_ [+] link. You can delete optional entries you don't need by choosing the [x]icon to the right of the row of fields or leaving the entries blank. The order of the fields does not influence the search.

  1. Select the _Apply Filters _ button to apply the criteria you selected.
    A list of cards that match these criteria is displayed.
  2. Choose cards to load by selecting checkboxes to the left of each entry, then choose the_ Select Cards_ button.

A list of selected cards and the Load Details section are displayed.

  1. Enter the load details:

i. Select a value in the Load From field: This field represents the funding account that the card will be loaded from. (The funding account must be used to be visible in the drop-down list).

๐Ÿ“˜ NOTE

When you load cards for the first-time using credit funds, those cards are linked to that particular credit funding account. You cannot load these cards using credit funds from different credit funding accounts in the future.

  1. Enter the Amount: This field represents the amount you want to load on each card.
    The_ Batch Card Load Details_ page is displayed and shows the progress of the batch load.

๐Ÿ‘ IMPORTANT:

The _Amount _ is the amount to be loaded onto each card, not the total amount to be loaded onto all cards (and split between them).

Unloading funds from a cardโ€‹

You can return money to a funding account from a card by unloading the card. Unloading, in other words, โ€˜emptiesโ€™ the card of funds.

  1. Select Cards > Manage Cards, select the โ‹ฎ icon in the row representing an active card, and select_ Unload Card_. Card details (including card images) are displayed on the Unload Card page. Select Card Details to see more.

  1. Enter details to unload the card:

i. Select a value in the Unload To field: This field represents the funding account you want to transfer the cardโ€™s funds to. (The funding account must be used to be visible in the drop-down list).

๐Ÿ“˜ NOTE

If you are unloading a card to a credit funding account, it can only be unloaded to the same credit funding account that you originally loaded it from.

ii. Enter the Amount: This field represents the amount you want to unload from the card. (The amount must be within allowed account limits).

๐Ÿ“˜ NOTE

The unload currency is displayed next to the _Amount _ field and is always the same as the cardโ€™s currency. If this currency is different than the destination currency, Forex fees may apply. Select the Forex calculator link to estimate your unload amounts based on current Forex conversion rates.

  1. Select the _Unload _ button to initiate the operation.
    Unloading is completed, and unload details are displayed.

Scheduled card loadsโ€‹

You can view the loads scheduled for the future on the Scheduled Loads page.

  1. Select Cards > Scheduled Loads.
    The Scheduled Loads page is displayed.

  1. If you need to modify the scheduled load list view:

    • Select a value next to Show heading to modify the number of scheduled loads listed on a single page (10, 25, or 50).
    • Enter or select values in the filter criteria fields (Funding Account, Currency, State, Schedule Date) and select the_ Apply Filters_ button to filter visible results.
  2. To export the list of scheduled loads to a file, select the_ Export to CSV_ link in the bottom right section of the page. (You can choose the _Close _ button in the confirmation window to close it. The export process will not be aborted).
    When the file generation process is complete, the Export to CSV link will be replaced by a Download File link. Select to Download.

  3. Select a value in the Card Reference column to view individual card details. From the Card Details page, you also delete and schedule loads

Viewing and managing cardsโ€‹

You can view card details and perform card operations on the Manage Cards page.

  1. Select Cards > Manage Cards.
    The Manage Cards page is displayed.

  1. If you need to modify the card list view:
    1. Select a value next to _Show heading _ to modify the number of scheduled loads listed on a single page (10, 25, or 50).
    2. Enter or select values in the filter criteria fields (Funding Account, Currency, State, Schedule Date) and select the Apply Filters button to filter visible results.
    • In the search box, you can also search by Card Number, Card reference, or Transaction reference.
  2. To export the card list to a file, select the Export Card Data link in the bottom right section of the page. (You can choose the _Close _ button in the confirmation window to close it. The export process will not be aborted.)
    When the file generation process is complete, the Export Card Data link will be replaced by a _Download File link. Select to download.
  3. Select a value in the Card Reference column to view individual card details.

๐Ÿ“˜ NOTE

The Available Balance displayed on this page is the cardโ€™s balance after an authorisation is received. The Actual Balance is the cardโ€™s after a settlement is complete.

  1. If you need to change cardsโ€™ custom fields on the_ Card Details_ page:
    1. Select the Add Additional Details [+] link to add more detailed entries. You can add a maximum of 20 custom fields per card. By default, 5 fields are displayed.
    2. To delete entries, select the [x] icon to the right of the row of fields, or leave them blank.

๐Ÿ“˜ NOTE

Your deployment may have additional custom fields configured by default. You cannot change the name of mandatory fields or delete them. You must provide a value for mandatory fields.

  1. You can modify scheduled loads for your cards on the Card Details page.

    1. You cannot change the amount and/or date of an existing scheduled load. You must delete the load and create a new one. Select the icon to delete an existing scheduled load.
    2. To add a new scheduled load, enter the Amount _ and select the calendar icon to choose the Load Date._
      Select the Save Changes button to add the scheduled load.
    3. Select or change the Clearance Date, if needed.
      Select a Clearance Date if you would like your card to be automatically deleted on a specific date. Any money left on the card will be transferred to the designated funding account. We recommend using this feature to reduce your risk of fraud, but you can only set a Clearance Date if you have at least one load scheduled on a card.
      If you choose a Single Load Card Type during card creation, you can only load your card once, either at the same time you create the card or in a single scheduled load. An error will be reported if you try to load it more than once. (This feature is typically used by customers who want to maintain tight control over card usage.)
  2. On the Manage Cards page, select the โ‹ฎ icon to manage a single card:

  • Select View Card Statement to view the card statement. See Viewing the card statement for more information.
  • Select_ Freeze Card_ to freeze the card. See Freezing cards for more information.
  • Select Thaw Card to thaw the card. See Thawing cards for more information.
  • Select Load Card to load the card. See Loading a card for more information.
  • Select Unload Card to unload the card. See Unloading funds from a card for more information.
  • Select_ Delete Card_ to delete the card. See Deleting cards for more information.
  1. To manage several cards at a time, select the checkboxes next to them in the first column and choose the action you want to take:
    • Select the _Freeze _ button to freeze the selected cards. (Only the cards that can be frozen will be included in the operation).
    • Select the _Thaw _ button to thaw the selected cards. (Only the cards that can be thawed will be included in the operation).
    • Select the _Delete _ button to delete the selected cards.

Viewing the card statementโ€‹

The card statement helps you keep track of card balances and review transaction activity for a specific card.

  1. Select Cards > Manage Cards.
    The Manage Cards page is displayed.
  2. Select the โ‹ฎ icon in the row representing the card you want to view the statement.
    The action menu is displayed.
  3. Select View Card Statement.
    The _Card Statement _ page is displayed.

Freezing cardsโ€‹

You can freeze active cards individually or as a batch.

  1. Select _ Cards > Manage Cards _to access the _Manage Cards _page.
    โ€ข To freeze a single card:
    1. Select the โ‹ฎ icon in the row that represents the card to be frozen.
      The action menu is displayed.
    2. Select Freeze Card.
  • To freeze multiple cards at once:

i. In the first column, select the checkboxes next to the cards you want to freeze.

ii. Select the Freeze _ button.
A batch reference is generated, and the
Batch Card Freeze Details_ report page is displayed.

The generated batch reference can be used later to search for reports.

Thawing cardsโ€‹

You can thaw inactive cards individually or as a batch.

  1. Select Cards > Manage Cards to access the Manage Cards page.
  • To thaw a single card:
  • i. Select the โ‹ฎ icon in the row that represents the card to be thawed.
    The action menu is displayed.
    ii. Select Thaw Card.
  • To thaw multiple cards at once:

i. In the first column, select the checkboxes next to the cards you want to thaw.

ii. Select the Thaw button.
A batch reference is generated and the Batch Card Thaw Details report page is displayed.

iii. The generated batch reference can be used later to search for reports. For more information, see Viewing Card Batches.

Deleting cardsโ€‹

You can delete cards individually or as a batch. When cards are deleted, any money remaining on them is transferred to the default funding account. For more information, see

To delete a card(s):

  1. Select Cards > Manage Cards _to access the _Manage Cards page.
    • To delete a single card:
      i. Select the โ‹ฎ icon in the row that represents the card to be deleted.
      The action menu is displayed.
      ii. Select Delete Card.
  • To delete multiple cards at once:
    i. In the first column, select the checkboxes next to the cards you want to delete.
    ii. Select the_ Delete button._
    A batch reference is generated, and the Batch Card Delete Details report page is displayed.

  1. The generated batch reference can be used later to search for reports. For more information, see Viewing Card Batches.

View card historyโ€‹

To view card history, use the Card History page.

  1. Select Cards > Card History.
    The search page of the Card History page is displayed.

  1. Provide the card history search criteria:
    • To search using the unique external identifier of the card, select the _By Card Reference _ radio button and enter the card reference in the Card Reference field.
    • To search using the unique name of the card, select the By Card Name radio button and enter the card name in the _Card Name _ field.
    • To search using the card's unique number, select the_ By Card Number_ radio button and enter the card number in the _ Card Number_ field.
    • To search using the unique user-defined external ID of the card, select the By Card External ID radio button and enter the ID in the Card External ID field.
    • To add a card brand criterion to the search, select a card brand from the Card Brand drop-down list.
    • Select a currency from the_ Card Currency_ drop-down list to add a card currency criterion to the search.
    • To add a transaction date range criterion to the search, enter or select dates in the From and To fields next to Transaction Date.

๐Ÿ“˜ NOTE

By Card Reference, By Card Name, By Card Number, and _By Card External ID _ are mutually exclusive search criteria. You can only select one of them. The remaining criteria can be added to the search and are not exclusive.

  1. If you need to add more advanced search criteria, select Advanced Search:
    • To add the unique external identifier of the transaction as a search criterion, enter this in the Transaction Reference field.
    • To add the transaction type as a search criterion, select this from the Transaction Type drop-down list.
    • To add the currency of the transaction as a search criterion, select this from the Transaction Currency drop-down list.
    • To add the transaction status as a search criterion, select this from the _Transaction Status _ drop-down list.
    • To add the transaction amount as a search criterion, enter this in the Transaction Amount field.

To add detail parameters as search criteria, enter the _Name _ and _Value _ fields in the Additional Details section. (These are optional details you entered when a card was created.)

  1. Select the _Search _ button to display a list of card history entries that match the search criteria.
    The result page of the Card History page is displayed.

  1. To view details of a specific card, select the vertical 3 dots icon in any row and choose View all details.
    The Card History Details page is displayed.

For a detailed explanation of the fields you may see on the Card History Details page, see Appendix: Card History Details.

  1. You can also export the list of card history entries to a file:
    1. Select the_ Export to CSV_ link below the list of entries on the Card History page. (You can select the Close button in the confirmation window to close it. The export process will not be aborted.)
      When the file generation process is complete, the Export to CSV _ link will be replaced by a Download File_ link. Select to download.

Appendix : View card history detailsโ€‹

This explains the fields on the Card History Details page.

FieldDescription
Start DateThe date when the transaction started.
Transaction DateThe date when the balance movement was performed.
CommunityThe name of the community that a client belongs to, as set up in Nium.
ClientThe name of the client (your company) as set up in Nium
Transaction ReferenceA unique transaction identifier.
Adjustment ReferenceA unique identifier for each balance movement.
NOTE: A transaction can have multiple balance movements.

The type of activity carried out on the card. These include the following transaction types:

Transaction typeโ€‹

Transaction typeDescriptionTransaction info field
TransferTransfers to or from this card.โ€ข If the client initiates the transfer, this field contains NULL.
โ€ข If Nium initiates the transfer, this field contains comments entered by the Nium officer.
AuthorisationThe receipt of an authorisation request for the card.Contains the authorisation reason.
Authorisation releaseThe cancellation of a previous authorisation request by the merchant.Contains the authorisation reason.
PurchaseThe receipt and processing of a settlement request for the card.NULL
Merchant refundThe receipt of funds on a card from a merchant. This includes both merchant refunds as well as original credit transfers that are processed through the Visa network.NULL
Manual creditA positive manual adjustment on a card.Contains comments entered by the Nium officer.
Manual debitA negative manual adjustment on a card.Contains comments entered by the Nium officer
Card createdThe creation of new cards (which could involve fund transfers).NULL
Card deletedThe deletion of cards (which could involve fund transfers).NULL
FreezeThe change of a card state to restricted.NULL
ThawThe change of a card state to active.NULL
Loss recoveryA negative card balance recovery.NULL
FieldDescription
Transaction AmountThis is the requested amount represented in transactionCurrency. This amount includes Forex padding (for authorisations) and any fees set at the processor level, if applicable.
For example, if the client requested 1000 GBP, the transactionCurrency is EUR, the current GBP to EUR exchange rate is 1.1, and the Forex padding is EUR 5, _transactionAmount _ is 1105: EUR 1100 from currency exchange plus EUR 5 Forex padding.
This amount does not include fees in case of cross-currency transfers.
Source TypeThe source participant in the transaction.
Source DetailsA friendly name of the source participant.
Destination TypeThe destination participant in the transaction.
Destination DetailsA friendly name of the destination participant.
Participation TypeThe type of transaction participant (this can be a source or a destination participant).
Participation Typeโ€‹
Funding AccountAn account maintained with Nium, used by the client to issue and load cards.
Virtual CardA virtual card issued through Nium for corporate purchasing or payments.
Bank CardThe account holderโ€™s bank card used to add money to the funding account.
Bank AccountA bank account registered in Nium for bank transfers.
Manual Accountโ€‹

Tagged accounts used by Nium for manual adjustments. These include the following:

RevshareThis account is used to show revenue share credits/debits.
Forex_FeeThis account is used to adjust forex credits/debits.
Misc_ClearingThis account adjusts one-off, occasional adjustments (supported by a note).
TestingThis account is used to adjust testing credits/debits.
Settlement_LossThis account is used to collect losses on client settlement processing.
Settlement_ChargeThis account collects fees associated with settlement charges (not managed by the system).
Dispute_FeeThis account is used to collect dispute fees on client requests.
Dispute_WonThis account is used to credit funds won related to disputes processed.
Card_FeeThis account is used to collect/refund card fee charges manually.
Transfer_FeeThis account is used to collect/refund fees generated on a transfer manually.
Bank_ChargeThis account is used to collect/refund fees associated with a bank transfer.
Tracing_ChargeThis account is used to collect/refund fees associated with a bank transfer trace.
Professional_FeeThis account is used to collect fees associated to a bespoke task that had previously communicated a charge
Setup_FeeThis account is used to collect/refund setup fees.

For card reports, participantType is always Virtual Card.

FieldDescription
Participation DetailsA friendly name of the participant. For example, bank account information (if the participant type is Bank Account), funding account name (if the participant type is Funding Account), and so on.
Participation SinkThe possible values are SOURCE or DESTINATION.
Original Transaction AmountThe amount requested by the client. This is independent of the participant's currency. For example, if the client requested 1000 GBP and _participantCurrency _is EUR, _originalAmount _is 1000.
Participation AmountThe requested amount is is represented in the participant's currency (see:_ participantCurrency_). For example, if the client requested 1000 GBP,_ participantCurrency _is EUR, and the current GBP to EUR exchange rate is 1.1, _participantAmount_ is 1100.
NOTE: At authorisation level there is no money movement, so if transactionType is Authorisation, then_ participantAmount_ is 0. The total amount blocked by the authorisation is represented in originalAmount and transactionAmount in respective currencies.
Exchange RateThe exchange rate used between source currency and destination currency (if they are different).
Non-Forex FeeContains non-Forex fees for the reported transaction, where applicable.
Forex FeeContains Forex fees for the reported transaction, where applicable.
Balance Before TransactionThe balance on the card before the transaction was processed.
Adjusted AmountRepresents the balance on the card after the transaction was processed. This excludes the fee amount.

This is used to keep track of transactions and can be one of six states:

Transaction status

CompletedThe transaction was completed successfully.
FailedTransaction failed, and no fund movements happened.
InitialisedThe transaction is suspended, and funds have only been partially moved.
Initialised completedThe transaction was previously suspended but has been resumed and completed. Funds have also been fully moved.
Initialised failedThe previously suspended transaction has been resumed and is now in a failed state. Any fund movements that happened initially have been reversed, and a new balance movement entry has been created.
FieldDescription
Transaction DirectionIndicates whether a transaction is an Advance or a Reversal.
Merchant NameThe name of the merchant.
Merchant CountryThe base country for the merchant as registered with their acquirer.
Merchant Category CodeAn identifier for the merchant category that a merchant belongs to.
Acquirer Reference NumberA unique reference number that identifies the acquirer for each merchant.
Authorisation CodeThe authorisation code used in authorisations and settlements. This can be used to match a settlement to its corresponding authorisation.
Processor DateThe date on which the transaction was processed at the card processor level. This is usually reported only for the authorisations and settlements.
Card ReferenceThe external ID of the card as supplied by the client and stored in the Nium system.
Card NumberThe first six and the last four digits of a card (for example, 406742****8806). This should not be used to match or map card numbers because multiple cards can share the same set of first six and last four digits. The card reference should be used instead.
Card BrandThe card scheme of the issued card (Visa, Mastercard, etc.)
Card TypeThe card factory (card type) that a card is linked to.
Custom Field 1 to Custom Field 20You may choose to pass specific information related to the transaction using custom fields and the IssueVirtualCard() API. This information is passed as_ name:value pairs_. Custom fields like this are typically used to reconcile card activity (payments and refunds).
For example, custom fields may contain the following information:
โ€ข Client Customer Identifier : John123
โ€ข Client Customer Booking Identifier : Paris321
โ€ข Client Travel Package Type Descriptor : LOWCOST
โ€ข Client Travel Package Identifier : LC21
โ€ข Client Company Subsidiary Descriptor : Spain
NOTE: In the Nium Portal, custom fields are referred to as additional details.

View authorisations and card referencesโ€‹

You can view a list of authorizations for a specific card on the _Authorisations _page.

  1. Select Cards > Authorisations.
    The Authorisations page is displayed.

  1. Enter your search criteria:
    • To search using the unique external identifier of the card (our recommended method), select the By Card Reference radio button and enter the card reference in the Card Reference field.

๐Ÿ“˜ Note:

You can find the Card Reference on the Manage Cards page in the Card Reference _ column or on the Card Details_ page in the _Card Reference _ field.
If you need to find and copy the Card Reference for a card, use the operating system copy function (for example, Ctrl + C).

  • To search using the unique name of the card, select the By Card Name radio button and enter this in the Card Name field.
  • To search using the card's unique number, select the By Card Number radio button and enter this in the _Card Number _ field.
  • To search using the unique user-defined external ID of the card, select the By Card External ID radio button and enter this in the_ Card External ID_ field.
  1. Select the _Search _ button to display a list of authorizations for the selected virtual card.
    The result page of the _Authorisations _ page is displayed.

Viewing card batchesโ€‹

You can view all card actions performed using batches.

  1. Select Cards > Card Batches.
    The Card Batches search page is displayed.

  1. Select how you want to search for card batches:
    • Select the Batch Reference radio button to search by batch references and enter the _ Batch Reference _ in the text field. (You can use wildcard symbols [*] in this field.)
    • To search by batch type and submission date, select the Batch Type and_ Batch Submission Date_ radio button, the Batch Type, and one of the radio buttons for_ Batch Submission Date_ options (for example, Yesterday) and enter or select dates for a Custom Range.
      To view a list of all card batches, leave the default settings.
  2. Select the _Search _ button.
    The Batch Card Reports page displays batch operations that match your search criteria.

  1. Select any value in the_ Batch Ref. No_. column to view the details of a batch.
    A page displays the selected card batch. The page name and type depend on the batch operation type.