AppZone API Documentation
  • Overview
    • Welcome
    • Getting Started
    • Enterprise User Oauth
  • Account
    • Account API
      • Create Account
      • Account Enquiry
      • Freeze Account
      • Unfreeze Account
      • Check Freeze Status
      • Place Lien on Account
      • Remove Lien on Account
      • Check Lien Status
      • Activate Post-No-Debit on Account
      • Deactivate Post-No-Debit on Account
      • Check Post-No-Debit Status
      • Retrieve BVN Details
      • Create Customer and Account
      • Update Account Tier2
      • Get Bank One Balance Enquiry
      • Generate Account Statement
      • Get Active Savings Accounts by CustomerID
      • Search Transactions
      • Get Transactions
  • Customer
    • Customer API
      • Create Customer
      • Update Customer
      • Get Customer by Account Number
  • Loans
    • Loan API
      • Get Loans By Customer Id
      • Get Loan Repayment Schedule
      • Loan Creation Application 2
      • Get Loan Account Balance 2
  • Account Officer
  • Standing Order
    • Standing Order API
      • Standing Order Creation Application2
      • Get Standing Orders By Debit Account Number
      • Cancel Standing Order
  • Fixed Deposit
    • Fixed Deposits API
      • Create Fixed Deposit Account
      • Get Fixed Deposit Account By Account Number
      • Get Fixed Deposit Account By Liquidation Account
      • Get Fixed Deposit Account By Phone Number
  • Transfers
    • Transfer API
      • Name Enquiry
      • Intra Bank (Local) Fund Transfer
      • Intra Bank Transfer
  • Cards
    • Cards API
      • Retrieve Institution Configurations
      • Card Request
      • Get Customer Cards
      • Hotlist Customer Card
      • Check Card Generation Status
      • Link Card to Customer Account
      • Freeze Cards
      • Unfreeze Cards
      • Add Transaction Limit to Customer Card
      • View Transaction Limit on Customer Card
      • Update Transaction Limit on Customer Card
      • Disable channel for customer card
      • Get Card Delivery Options
      • Re-Enable Channel for Customer Card
  • Overdraft
    • Overdraft API
      • Create Overdraft
      • Get Overdraft Interests
      • Get Overdraft Fees
  • Transactions
    • Transactions API
      • Transaction Status Confirmation
      • Credit Customer Account
      • Debit Customer Account
      • Reversals
  • Bills Payment
    • Bills Payment API
      • Get Commercial Bank
      • Get Billers
      • Get Billers Category
      • Get Payment Items
      • Initiate Bills Payment Transaction
  • Messaging
    • Save Bulk SMS
    • Save Email
Powered by GitBook
On this page
  1. Cards
  2. Cards API

Link Card to Customer Account

This links generated card to customers account.

After the card files have been generated, printed by the issuer and personalization company. The card delivery needs to be acknowledged on the portal then the card needs to be linked to the customer account

To successfully link a card to customer's account you make a post request to the link card to customer account endpoint by making a post request and passing Token, SerialNo, AccountNumber, and Reference in the request body.

Here is an example on how to make the post request with sample payload and response to the staging URL.

// Live URL 
http://api.mybankone.com/thirdpartyapiservice/apiservice/Cards/LinkCustomerCard

POST https://staging.mybankone.com/thirdpartyapiservice/apiservice/Cards/LinkCustomerCard

Request Body

Name
Type
Description

Token*

String

Authentication Key for the request

SerialNo*

String

Card serial number can be gotten from RetrieveCustomerCards endpoint

AccountNumber*

String

Requesting customer’s account number

Reference*

String

Unique reference per request

{
 "IsSuccessful": True,
 "ResponseMessage": “Link card successful.",
 "Reference": "234678"
}

PreviousCheck Card Generation StatusNextFreeze Cards

Last updated 3 years ago