Juice Financial
  • Introduction
  • ErrorCodes
  • Authentication
  • APIS
    • Administration
      • Add ACH Transaction
      • Add Processor Real Time Txn
      • Allocate Inventory
      • CardNo to RPCBB Conversion
      • Change Password
      • Check DB Up Request(Monitoring)
      • End Card Session
      • Force Change Password
      • Get Billers List
      • Get Card Effective Fee
      • Get Card Session Details
      • Get Mobile Upgrade
      • Get Product Types
      • Login
      • Manage AML Exception
      • Manage Card Session
      • Manage Code Group
      • Manage Daily Limit
      • Manage FBE
      • Manage Fee
      • Manage File
      • Manage Load Account
      • Manage Order
      • Manage Org To Orgs Relation
      • Manage Praxell Code
      • Manage Sub Organization
      • Manage Terminal
      • Manage User
      • Manage White List
      • Ping
      • Reprocess ACH Transaction
      • Reset Password
      • Resolve Card Session
      • Set Single Day Override
      • Start Card Session
      • Update ACH Transaction Status
      • Validate Inventory Location
      • Validate Product Type
      • View Debit Organizations Hierarchy
    • Card Issuance
      • Activate-Card
      • Instant-Issue-Card
      • New-Card
    • Card Status & Management
      • Change-Card-Pin
      • Close-Card
      • Free Card
      • Get Card Balance
      • Get Card Details
      • Get Card Holder Spend Limits
      • Get Card Holds
      • Get Card Report
      • Get Cards Report
      • Get Card Text Info
      • Inform Lost Stolen Card
      • Load Network Verify Card
      • Lock Card
      • Reopen Card
      • Request OTP
      • Research Card
      • Reset Card PIN
      • Return To Inventory
      • Search Cardholder
      • Suspend Card
      • Swap Cards DDAs
      • Unlock Card
      • Unsuspend Card
      • Update Card Holder Spend Limits
      • Update Card Replacement Status
      • Update Cardholder DOB
      • Update Cardholder
      • Update Fee Less Card
      • Verify Card PIN
      • Verify Cardholder
      • Verify OTP
    • Cardholder Management
      • Change Cardholder Password
      • Enroll Cardholder
      • Get Cardholder Details
      • Reset Cardholder Password
    • Transactions
      • Card to Card Transfer
      • Charge Fee
      • Load Network Reload Card
      • Load Network Unload Card
      • Load Network Verify Card
      • Load Network Void Card
      • Pay CH Bill
      • Reverse Fee
      • Webhook Examples
Powered by GitBook
On this page
  • ActivateCard
  • Input Parameters:
  • Output Parameters:
  • XML Samples
  • Input XML
  1. APIS
  2. Card Issuance

Activate-Card

ActivateCard

The Activate Card API requests to activate a card, this operation sets the card's initial PIN. The activation is done by providing the Date of birth and the CVV (the CVV parameter is part of the general XML Authentication part - see XML sample)

Input Parameters:

Name
Required
Definition
Comments

CardNumber

C

Format: Numeric, 16

Mutually exclusive with ID. Deprecated (use ID/ID Type)

DateOfBirth

C

Format: yyyy-mm-dd Description: Cardholder must be above 17 years old

must provide DateOfBirth or Last4OfID

Last4OfID

C

Format: 4 characters long, numbers or alphanumeric. Description: Last 4 characters of the SSN (or any other Government Issue ID) the cardholder registered with

must provide DateOfBirth or Last4OfID

ID

C

Format: Numeric, 1-19 Description: Input should be RPID in case IDType = RPID Input should be Card Number in case IDType = CardNumber

Mutually exclusive with CardNumber. Required if IDType is provided

IDType

N

Format options: CardNumber RPID SavingAccount

relevant only for ID parameter (CardNumber is default)

NewPin

C

Format: Numeric, 4 Description: New PIN value of private code, represented as 4 digits

Optional only if NoPINActivation=Y. Otherwise, Required

NewPin2

C

Format: Numeric, 4 Description: New PIN value verification, repeats the NewPin value

Optional only if NoPINActivation=Y. Otherwise, Required

NoPINActivation

N

OrgId

N

Format: Alphanumeric, 20 Value can be multiple org_id’s split by commas

Output Parameters:

Name
Definition
Failure Case
Success Case
Comments

CardBalance

Format: Numeric, 11

Not returned

Returned

CardIssuingBank

Format: Alphanumeric, 30

Not returned

Returned

CardStatus

"Active" (ACT) "Suspended" (SPND) "Card In Inventory" (CII) "Spoilt" (SPLT) "Cardholder Close" (CC) "Lost" (LST) "Locked" (LOCK) "Locked Card In Inventory" (LOCK_CII) "Stolen" (STLN) Description: All application cards status descriptions (as Active, Suspended)

Not returned

Returned

CardStatusId

Format options: ACT, CC, CII, LOCK_CII, LOCK, LST, SPLT, SPND, STLN

Not returned

Returned

CardType

Format: Alphanumeric, 10

Not returned

Returned

ExpirationDate

Format: MMYY

Not returned

Returned

IsAssigned

Format: Y/N

Not returned

Returned

IsRetailCard

Format: Y/N Description: Indicates whether the card is part of a retail pack and is it a retail card

Not returned

Returned

IssueDate

Format: YYYY-MM-DD HH:MM:SS.M

Not returned

Returned

IssuerName

Format: Alphanumeric, 30

Not returned

Returned

ReplacementMessageType

Format options: ToBeReplacedInAnotherBankForVerifiedCH ToBeReplacedInAnotherBankForRNVCH PTExpirationDate CardExpirationDate ReplacementCardOrderedFromAnotherBank ReplacementCardOrderedFromSameBank ReplacedAnotherCardInAnotherBank

Not returned

Returned

ReplacementStatus

Format options: CardReplaced ReplacementCardObsolete ReplacementCardOrderedFromSameBank ReplacementCardOrderedFromAnotherBank ReplacedAnotherCardInSameBank ReplacedAnotherCardInAnotherBank ReplacementCardRequired ReplacementCardRequiredFailure ToBeReplacedInAnotherBank ToReplaceCardFromAnotherBank ToReplaceCardFromSameBank

Not returned

Returned

XML Samples

Input XML

<?xml version="1.0"?>
<PraxellXMLRequest>
  <AuthenticationDetails>
    <AuthCardNumber>1234567890000012</AuthCardNumber>
    <AuthCVV>123</AuthCVV>
    <AuthDOB>1978-04-08</AuthDOB>
    <ClientSourceIP></ClientSourceIP> 
 </AuthenticationDetails> 
 <ServiceDetails>
    <UniqueRequestId>963369551</UniqueRequestId>
    <ServiceName>ActivateCard</ServiceName>
  </ServiceDetails>
  <Origin>
    <OriginType>ExtAPI</OriginType>
  </Origin>
  <ServiceParams>
    <CardNumber></CardNumber>
    <DateOfBirth>1978-04-08</DateOfBirth>
    <ID>1234567890123456</ID>
    <IDType>CardNumber</IDType>
    <NewPin>6045</NewPin>
    <NewPin2>6045</NewPin2>
    <OrgId>1234</OrgId>
  </ServiceParams>
</PraxellXMLRequest>
<?xml version="1.0"?>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>ActivateCard</ServiceName>
        <SessionId>38097317201110064</SessionId>
        <StatusCode>0</StatusCode>
        <StatusName>StatusOK</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2021-02-25 17:10:40</ServiceDate>
        <ServiceId>38097317201110064</ServiceId>
    </ResponseDetails>
<ResponseParams>
    <CardStatus>Active</CardStatus>
    <CardStatusId>ACT</CardStatusId>
    <IsRetailCard>Y</IsRetailCard>
    <IsAssigned>Y</IsAssigned>
    <IssueDate>2021-02-25 15:20:19.0</IssueDate>
    <CardIssuingBank>IssuingBanktest900</CardIssuingBank>
    <ExpirationDate>0413</ExpirationDate>
    <CardType>999999999</CardType>
    <CardBalance>1999</CardBalance>
    <IssuerName>Store</IssuerName>
    <ReplacementStatus>ReplacedAnotherCardInSameBank</ReplacementStatus>
    <ReplacementMessageType></ReplacementMessageType>
</ResponseParams>
</PraxellXMLResponse>
<?xml version="1.0"?>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>ActivateCard</ServiceName>
        <SessionId>38553811201107063</SessionId>
        <StatusCode>70022</StatusCode>
        <StatusName>INVALID CARD ACTIVE STATUS</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2021-02-25 11:07:39</ServiceDate>
        <ServiceId>38553811201107063</ServiceId>
    </ResponseDetails>
</PraxellXMLResponse>
PreviousCard IssuanceNextInstant-Issue-Card

Last updated 7 months ago