post
https://sandbox-api.helix.q2.com/card/unlock
Unlock a card by the Helix-assigned cardId.
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.