Change Cardholder Password

Change Cardholder Password

The Change Cardholder Password API allows changing the cardholder password and returning the needed information for login logic.

Input Parameters:

Name
Required
Definition
Comments

GetHoldsBalance

N

Format: Y/N (Default = N)

Latitude

N

Format: Alphanumeric, Comma, Dot, "-", 1-8 (can be 40.71435) Description: Latitude can range between 0 and 90 degrees, and can be north or south. (Zero degrees latitude is neither north nor south.) The North Pole is at 90° north latitude; the South Pole is at 90° south latitude. The Equator is at zero degrees latitude.

Longitude

N

Format: Alphanumeric, Comma, Dot, "-", 1-9 (can be -74.00597) Description: Longitude can range between 0 and 180 degrees, and can be east or west. (Zero and 180 degrees longitude are neither east nor west.) The Greenwich Meridian, which passes through the United Kingdom, is at zero degrees longitude (unlike zero degrees latitude, the zero point for longitude is just an arbitrary choice, made for historical reasons).

NewCardholderPassword

Y

Format: Alphanumeric, 6 -10 (including char: ‘_’)

OrgId

N

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

Output Parameters:

Name

Definition

Failure Case

Success Case

Comments

Format: Alphanumeric, 6 -30 (including chars: ‘_’ ,‘-‘)

Not returned

Returned

Format: Numeric, 20

Not returned

Returned

Format: Numeric, 16

Not returned

Returned

Returned in list of DefaultAccountCards/DefaultAccountCard which return all cards related to the default account

Format: Numeric, 1-19

Not returned

Returned

Returned in list of DefaultAccountCards/DefaultAccountCard which return all cards related to the default account

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

Not returned

Returned

The status of the card provided in input parameter (before the API has run)

Format options: CardExpired CardReplaced CIPException CloseCardForDispute Closed ClosedByPM Deceased Excess-Chargeback InsufficientKYC InvalidArrowEyefiles NegativeWriteOff POBox PrePurge PurgedCard PurgedFailedAtProcessor ReadyToPrint Arbitration ByPM CIPExceptionSus Confirmed Fraud Dispute Lost Lost-Stolen Other Poss Fraud Poss Fraud Warm Address Poss Fraud Warm Source IP PrimaryCardSuspension ProcSuspectedFraudWithNotes ReDisputed ReplaceFailure ReplacementCardRequired Represented Stolen StoreError SuspectedFraud TransactionCompletenessException UnactivatedCard UnactivatedReplacementCard Violation

Not returned

Returned

The status reason of the card provided in input parameter (before the API has run)

Format: Numeric, 20 Description: Praxell Account ID

Not returned

Returned

Returned in list of Accounts (default account for UserName is saved in field DefaultAccountID)

Format: Numeric, 16

Not returned

Returned

Returned in list of Accounts

Format: Numeric, 1-19

Not returned

Returned

Returned in list of Accounts

Format: Alphanumeric, 10

Not returned

Returned

Returned in list of Accounts

Format: Alphanumeric, 15

Not returned

Returned

Returned in list of Accounts

Format: YYYY-MM-DD

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 11 Description: Number of active holds existing for Cardholder

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 11 Description: Total amount of all active holds existing for Cardholder

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 12, Month YYYY Description: example, April 2013

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 30

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 30

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alpha, 1-120

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 11

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 3-16

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 30

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 5

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 9

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 16

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

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

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

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

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format options: NRNV RNV V-PNS V

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 20

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: ISO Country code. Two characters. Description: Based on ISO 3166-1 alpha-2 list. http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

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

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 3-16 Description: ID number of the government identification document used (defined in DocType)

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format options: SSN PASS UDL MCN INMATE Description: Closed list of values.Type of government identification document used: SSN- Social Security Number, PASS - Passport number, 'UDL' – US Drivers license number,'MCN' - Matricula consular ,INMATE.

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: a-z (upper or lower), numbers, dash and underscore, 5-40 Description: Possible pattern: x@x.x

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: MMYY

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 6-10 Description: the fax number.

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 16

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 10

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Y/N

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format options: Enabled (the cardholder has requested to receive an SMS and therefore he get SMS's) Disabled (the cardholder has requested to not receive an SMS and therefore he does not get SMS's) Blank (the cardholder has not requested to receive an SMS and therefore he does not get SMS's) Description:Defines if the cardholder gets an SMS.

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Y/N

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

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

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 30

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Y/N

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 15

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alpha,1 Description: Middle name char of the cardholder.

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 6-15 Description: Mobile phone for getting SMS (see IsReceiveSms).

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 6-15 Description: Phone number

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 1-120 Description: Each sub program in Praxell consists of one or more product types. A product type is a set of attributes that are applied to the cards that belong to this product type. The ProductTypeName field is the name of the product used when creating and issuing cards.

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Saving/Commercial/GPR

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 30

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: MMYY

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 1-120 Description: Product Type known name.

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format options: ToBeReplacedInAnotherBankForVerifiedCH ToBeReplacedInAnotherBankForRNVCH PTExpirationDate CardExpirationDate ReplacementCardOrderedFromAnotherBank ReplacementCardOrderedFromSameBank ReplacedAnotherCardInAnotherBank

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

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

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 1-19

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Alphanumeric, 2

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format options: CardExpired CardReplaced CIPException CloseCardForDispute Closed ClosedByPM Deceased Excess-Chargeback InsufficientKYC InvalidArrowEyefiles NegativeWriteOff POBox PrePurge PurgedCard PurgedFailedAtProcessor ReadyToPrint Arbitration ByPM CIPExceptionSus Confirmed Fraud Dispute Lost Lost-Stolen Other Poss Fraud Poss Fraud Warm Address Poss Fraud Warm Source IP PrimaryCardSuspension ProcSuspectedFraudWithNotes ReDisputed ReplaceFailure ReplacementCardRequired Represented Stolen StoreError SuspectedFraud TransactionCompletenessException UnactivatedCard UnactivatedReplacementCard Violation

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format options: Card Expired Card Replaced CIP Exception Close Card Submited for Dispute Closed Closed By PM Deceased Excess-Chargeback Insufficient KYC Invalid Arrow Eye files Negative Write-off POBox Pre Purge Purged Purged Failed At Processor Ready To Print Arbitration By PM CIP Exception Confirmed Fraud Dispute Lost Lost - Stolen Other Poss Fraud Poss Fraud Warm Address Poss Fraud Warm Source IP Primary Card Suspension Processor Suspected Fraud With Notes Re-disputed Replace Failure Replacement Card Required Represented Stolen Store error Suspected Fraud Suspected Fraud Transaction Completeness Exception Unactivated Card Unactivated Replacement Card Violation

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Y/N Description: Return yes if current card has at least one related card in status SPND/Unactivated Replacement Card

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 5

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: YYYY-MM-DD

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 10

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 10

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: Numeric, 16

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Primary/Secondary (field called CardType in APIs)

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: List of values: Credit, Debit

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Y/N

Not returned

Returned

Field relevant to the default account' current card (Returned in DefaultAccountCurrentCardDetails XML tag)

Format: MM-DD-YYYY Description: The date the holds expired

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Alphanumeric, 4

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

(Alphanumeric, 1-200. can contains as well all special characters beside: <, >)

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Alphanumeric, 25

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Alphanumeric, 25

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Numeric, 11

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Alphanumeric, 6

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: YYYY-MM-DD

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Alphanumeric, 100

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Alphanumeric, 200

Not returned

Returned

Returned in ~ LastTransactions/Transaction XML tag

Format: Y/N

Not returned

Returned

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

Not returned

Returned

Returned in list of Accounts

Format options: CardExpired CardReplaced CIPException CloseCardForDispute Closed ClosedByPM Deceased Excess-Chargeback InsufficientKYC InvalidArrowEyefiles NegativeWriteOff POBox PrePurge PurgedCard PurgedFailedAtProcessor ReadyToPrint Arbitration ByPM CIPExceptionSus Confirmed Fraud Dispute Lost Lost-Stolen Other Poss Fraud Poss Fraud Warm Address Poss Fraud Warm Source IP PrimaryCardSuspension ProcSuspectedFraudWithNotes ReDisputed ReplaceFailure ReplacementCardRequired Represented Stolen StoreError SuspectedFraud TransactionCompletenessException UnactivatedCard UnactivatedReplacementCard Violation

Not returned

Returned

Returned in list of Accounts

Format:Inventory or Fullfilemnt

Not returned

Returned

Returned in list of Accounts

Format: Numeric, 11

Not returned

Returned

Returned in list of Accounts

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>
    <ServiceName>ChangeCardholderPassword</ServiceName>
    <UniqueRequestId>1212121212121213</UniqueRequestId>
  </ServiceDetails>
  <Origin>
     <OriginType>ExtAPI</OriginType>
  </Origin>
 <ServiceParams>
    <GetHoldsBalance>Y</GetHoldsBalance>
    <Latitude>12.1</Latitude>
    <Longitude>14.2</Longitude>
    <NewCardholderPassword>123456</NewCardholderPassword>
    <OrgId>11111111111111111111</OrgId>        
 </ServiceParams>
</PraxellXMLRequest>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>ChangeCardholderPassword</ServiceName>
        <SessionId>37996606200818094</SessionId>
        <StatusCode>0</StatusCode>
        <StatusName>StatusOK</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2008-09-21 06:18:47</ServiceDate>
        <ServiceId>37996606200818094</ServiceId>
    </ResponseDetails>
    <ResponseParams>
	<LoginCardDetails>
  	       <LoginCardStatus>ACT</LoginCardStatus>
	       <LoginCardStatusReason></LoginCardStatusReason>
	</LoginCardDetails>
	<CardholderPassword>myUserName</CardholderPassword>        
	<DefaultAccountID>11111111111111111111</DefaultAccountID>
        <DefaultAccountCards>
		<DefaultAccountCard>
		         <DefaultAccountCardNumber>1111111111111111</ DefaultAccountCardNumber >
			<DefaultAccountCardRPID>2222222222222222222</ DefaultAccountCardRPID > 
		</DefaultAccountCard>
		<DefaultAccountCard>
		         <DefaultAccountCardNumber>3333333333333333</ DefaultAccountCardNumber >
			<DefaultAccountCardRPID>5555555555555555555</ DefaultAccountCardRPID > 
		</DefaultAccountCard>
        </DefaultAccountCards>
	<Accounts>
		 <Account>
			   <AccountID>22222222222222222222</AccountID>
			   <AccountCurrentCardNumber>1111111111111111</AccountCurrentCardNumber>
			   <AccountCurrentCardRPID>2222222222222222222</AccountCurrentCardRPID>
			   <AccountCurrentCardFirstName>name</AccountCurrentCardFirstName>
			   <AccountCurrentCardLastName>name</AccountCurrentCardLastName>
	     <Account>
	<Accounts>
	<DefaultAccountCurrentCardDetails>
		<ActivationDate></ActivationDate>
		<ActiveHoldsNumber>03</ActiveHoldsNumber>
		<ActiveHoldsTotalAmount>120865</ActiveHoldsTotalAmount>
		<ActualExpirationDate>February 2011</ActualExpirationDate>
		<AddressLine1>1270 Broadway</AddressLine1>
		<AddressLine2>Suite 1207</AddressLine2>
		<Brand></Brand>
		<CardAvailableBalance>1999</CardAvailableBalance>
		<CardDDA>1234111778452</CardDDA>
		<CardIssuingBank>IssuingBanktest900</CardIssuingBank>
		<CardIssuingBankCode>MB</CardIssuingBankCode>
		<CardIssuingBankRoutingNumber>789123456</CardIssuingBankRoutingNumber>
  	        <CardNumber>1111111111111111</CardNumber>
		<CardStatus>ACT</CardStatus>
		<CardStatusId>ACT</CardStatusId>
		<CHState>V</CHState>
		<City>New York</City>
		<Country>US</Country>
		<DateOfBirth>1980-01-01</DateOfBirth>
		<DocId>123456789</DocId>
		<DocType>SSN</DocType>
		<Email>qa@praxell.com</Email>
		<ExpirationDate>0211</ExpirationDate>
		<Fax>2126296232</Fax>
		<FBEDDA></FBEDDA>
		<FirstName>Static</FirstName>
		<IsPinSet>Y</IsPinSet>
		<IsReceiveSms></IsReceiveSms>
		<IsRegistered>Y</IsRegistered>
		<IssueDate>2010-07-20 18:25:02.0</IssueDate>
		<IssuerName>Store</IssuerName>
		<IsVerified>Y</IsVerified>
		<LastName>Data</LastName>
		<MiddleInitial></MiddleInitial>
		<MobilePhone></MobilePhone>        
		<Phone>2126296040</Phone>
		<ProductTypeName>DevOnly</ProductTypeName>
		<PT>1360</PT>
		<PTExpirationDate></PTExpirationDate>
		<PTFriendlyName>DevOnly</PTFriendlyName>
		<ReplacementMessageType>CardExpirationDate</ReplacementMessageType>
		<ReplacementStatus></ReplacementStatus>
		<RPID>9999999999998068</RPID>
		<State>NY</State>
		<StatusReasonCode></StatusReasonCode>
		<StatusReasonDesc></StatusReasonDesc>
		<UnactivatedReplacementCardExist></UnactivatedReplacementCardExist>
		<Zip>10001</Zip>
		<ProgramType></ProgramType>
		<CardType></CardType>
		<EarlyAccess></EarlyAccess>
		<ACalcEffectiveDate></ACHCalcEffectiveDate>
		<ACHPendingLoads></ACHPendingLoads>
		<ACHPendingUnloads></ACHPendingUnloads>
	</DefaultAccountCurrentCardDetails>
	<LastTransactions>
	   <Transaction>
		<CardNumber></CardNumber>
		<ContextTransactionType></ContextTransactionType>
		<HoldExpirationDate></HoldExpirationDate>
		<MCC></MCC>
		<MCCDescription></MCCDescription>
		<TermCity></TermCity>
		<TermOwner></TermOwner>
		<TransactionAmount></TransactionAmount>
		<TransactionCode></TransactionCode>
		<TransactionPraxellDate></TransactionPraxellDate>
		<TransactionPraxellDescription></TransactionPraxellDescription>
		<TransactionPraxellDisplayDescription></TransactionPraxellDisplayDescription>
   	<Transaction>
	<LastTransactions>

   </ResponseParams>
</PraxellXMLResponse>
<?xml version="1.0"?>
<PraxellXMLResponse>
  <ResponseDetails>
    <ServiceName>ChangeCardholderPassword</ServiceName>
    <SessionId>07071612200737105</SessionId>
    <StatusCode>7000</StatusCode>
    <StatusName>InvalidPassword</StatusName>
    <StatusDescription>InvalidPassword</StatusDescription>
    <ServiceDate>2021-10-01 12:37:50</ServiceDate>
    <ServiceId>07071612200737105</ServiceId>
  </ResponseDetails>
  <ResponseParams>
  </ResponseParams>
</PraxellXMLResponse>

Last updated