Plastics Management API

Download
โ˜…โ˜…โ˜…โ˜…โ˜…
(0 reviews)

Technical Notes

/connex/card.get

Restriction: The following two values - IncludePrimaryMemberOnly and IncludeAccountDetails - only cannot both be set to true at the same time.


/connex/cvv.get

The CVV GET API provides functionality to retrieve CVV2/CVC2 for accounts when queried.

NOTE:

  1. For this endpoint, the Event Identifier is a CLIENT generated field that is sent back to the requestor. The EventIdentifier field is used to trace the request at the switch end for troubleshooting when issues are found. This is mandatory in the request to generate the Audit trace for the Switch to trace back to the requestor.
  2. Expiration Date Format is both YYYYMM or MMYYYY.

The Key Wrap is the key obtained by the customer using the Encryption API for the Base64 encoded value for their key, which the Client will use to decrypt the encrypted value when received from the API.

  1. The key wrap in the Encryption API is a pre-requisite step for this Connex CVV endpoint for Co-Op clients.
  2. You MUST send a wrappedkey for every Connex CVV Get call, and the Response will return an encrypted CVV code based on the Encryption API's key wrap endpoint.
  3. To decrypt the CVV code, you must use the following JAVA code:
static String decryptClaim(final String key, String claim) throws ParseException, JOSEException {
    JWEObject jweObject = JWEObject.parse(claim);
    byte[] keyBytes = key.getBytes();
    SecretKey secretKey = new SecretKeySpec(keyBytes, 0, keyBytes.length, "AES");
   jweObject.decrypt(new AESDecrypter(secretKey));
    return jweObject.getPayload().toString();
}

The dependency below also need to be added in the JAVA project in order to run the JAVA program:


 <dependency>
   <groupId>com.nimbusds</groupId>
   <artifactId>nimbus-jose-jwt</artifactId>
   <version>5.9</version>
</dependency>

Please refer to the Plastics and PIN Mailer Rush Codes Table for the parameter - rushMailingCode - for the following endpoints:

  • /omaha/pin-mailer
  • /omaha/card-issuance-detail.get
  • /omaha/emboss-plastic
  • /omaha/pending-emboss-orders.get

/omaha/new-account

  • Please refer to the Plastics and PIN Mailer Rush Codes Table for the parameter - rushPlasticCode.
  • Please refer to the Valid U.S. and Canadian Province Codes in the Technical Notes wiki for the Demographics API for this endpoint's input parameter - State.

/omaha/instant-issue

  1. Use this Request API before to GetInstantIssueDetails for EMV chip card instant issuance.
  2. Before calling this Request API, set the Plastic Count to zero (0) for new accounts in order to prevent shipping a card.
  3. This RequestInstantIssuance API will be set the Plastic Count for ordered EMV cards to 1, regardless of the current plastic count.
  4. Allow 2-3 processing days after the Instant Issue request is submitted.

/omaha/instant-issue.get

Instant Issuance is used by Issuers to produce plastics for their cardholders.

This GetInstantIssueDetails API follows the RequestInstantIssuance API call for EMV chip card instant issuance, with a 1-2 minute delay before returning any EMV information. Limit the number of calls to this GetInstantIssueDetails API as each call is billable. Account details can only be retrieved once and cannot be retrieved again by the system once the request is marked.


/omaha/emboss-plastic

This endpoint is also used to enter special handling information when shipping cardholder plastics and plastics-related products when using an overnight courier service. This API is used by Card Issuance Unit (CIU) clients.

This API may be used by Single Entity and Separate Entity clients.


/omaha/emv-script-history.get

The โ€œRecord Not Foundโ€ error message is returned when no script history is found for the account number.


Reviews

Plastics Management API doesn't have any reviews yet