Card Linking – Function 032
Function 032 requests help link two cards together to the same account. It takes the Card Number (Primary Account Number) associated with the primary account and the card number to be linked as the input parameters.
This transaction can also be used to reverse a link if there have been no transactions since the cards were initially linked. To reverse a link use the Primary Account Number (Card Number) as the P2 input and the card to be unlinked as the P1 input.
| Inputs | Description | Required | Data Type |
|---|---|---|---|
| FunctionID | 032 | Y | |
| P1 | Primary Account Number | Y | (16,19) Numeric |
| P2 | Card To be Linked | Y | (16,19) Numeric |
| Outputs | Description | ||
| P1 | Error Code | Y | |
| P2 | Error Text | Y |
Processing notes:
1. Linked cards must be within the same BIN/Sub-BIN P1=5809&P2=BIN #s don`t match
2. A card link cannot be reversed if a transaction has been processed after the link was completed. P1=5832&P2=Cannot reverse link
3. A primary account cannot be designated as a secondary account to another primary account. P1=5811&P2=Second card is a primary
4. A secondary account cannot be linked to another primary account until the original link is reversed. P1=5817&P2=Second card already linked
Example: Card Linking Request
https://api.m2fin.com
/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwordassignedtome&FUN
C=0 32 &MSGID=00001089067000027&P1=4023540100000041&P2=4023540100000058
/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwordassignedtome&FUN
C=0 32 &MSGID=00001089067000027&P1=4023540100000041&P2=4023540100000058
Example: Card Linking Response
P1=0000&P2=Card Linking Successful P1=0001&P2=Card Link Reversed
Error Codes
• LINK CARDS
5811 – Second card is a primary 5813 – Primary card is secondary 5815 – Link already set 5817 – Second card already linked.
• The following errors indicate a possible issue with transaction history 5821 – SYNC BALANCES
(A1) 5822 – SYNC BALANCES (L1)
5823 – SYNC BALANCES (A2)
5824 – SYNC BALANCES (L2)
• REVERSE LINK
5811 – Second card is a primary 5813 – Primary card is secondary 5815 – Link already set 5817 – Second card already linked.
• The following errors indicate a possible issue with transaction history 5821 – SYNC BALANCES
(A1) 5822 – SYNC BALANCES (L1)
5823 – SYNC BALANCES (A2)
5824 – SYNC BALANCES (L2)
• REVERSE LINK
5830 – Card not a secondary 5832 – Cannot reverse link