post
https://sandbox-api.helix.q2.com/card/unlock
Unlock a card. Can be reversed by calling /card/lock. The following matrix details when this call will succeed or fail.
| Current lockTypeCode | Current lockReasonTypeCode | Result |
|---|---|---|
CST | UNK - Uknown | Success |
CST | DMG - Physical Damage | Success |
CST | TMP - Temporary | Success |
CST | ADM - Administrative | Success |
CST | LST - Lost | Fail - Lost cards can never be used again |
CST | STL - Stolen | Fail - Stolen cards can never be used again |
CST | FRD - Suspected Fraud | Fail - Suspected Fraud cards can never be used again |
SYS | LST - Lost | Fail - Lost cards can never be used again |
SYS | STL - Stolen | Fail - Stolen cards can never be used again |
SYS | FRD - Suspected Fraud | Fail - Suspected Fraud cards can never be used again |
SYS | ADM - Administrative | Fail - Only Admin Console or an automated process can unlock |
SYS | PIN - PIN Retry Limit Exceeded | Fail - Only Admin Console or an automated process can unlock |
SYS | TMP - Temporary | Fail - Only Admin Console or an automated process can unlock |
The card will have a lockTypeCode of UNL upon successful completion of this call. The card will be unlocked and ready for transactions to take place.
Unlocks a card. This action can be reversed by calling /card/lock.
The following matrix details when this call will succeed or fail.
Current lockTypeCode | Current lockReasonTypeCode | Result |
|---|---|---|
| CST | UNK - Unknown | Success |
| CST | DMG - Physical Damage | Success |
| CST | TMP - Temporary | Success |
| CST | ADM - Administrative | Success |
| CST | LST - Lost | Fail — Lost cards can never be used again |
| CST | STL - Stolen | Fail — Stolen cards can never be used again |
| CST | FRD - Suspected Fraud | Fail — Suspected Fraud cards can never be used again |
| SYS | LST - Lost | Fail — Lost cards can never be used again |
| SYS | STL - Stolen | Fail — Stolen cards can never be used again |
| SYS | FRD - Suspected Fraud | Fail — Suspected Fraud cards can never be used again |
| SYS | ADM - Administrative | Fail — Only Admin Console or an automated process can unlock |
| SYS | PIN - PIN Retry Limit Exceeded | Fail — Only Admin Console or an automated process can unlock |
| SYS | TMP - Temporary | Fail — Only Admin Console or an automated process can unlock |
Result of a Successful Unlock
If the call succeeds:
- The card will have a
lockTypeCodeofUNL. - The card will be unlocked.
- The card will be ready for transactions.