Accounts and Cards

Replace Lost/Stolen Card

Use the Replace Lost/Stolen Card endpoint to report a card as lost or stolen and to request a replacement card. This endpoint is valid only for physical cards and Digital First cards. The response from this endpoint includes the new <glossary:PAN>, new <<glossary:expiry date>>, and new <glossary:CVV> for the replacement card. You must be PCI-compliant to receive the full PAN; otherwise, you will receive a masked PAN.

post/replaceLostStolenCard

Request

  • Base URL
    api-{corename}.{env}.gpsrv.com/intserv/4.0/ (relative, and the document’s source URL is not known)
  • URL
    api-{corename}.{env}.gpsrv.com/intserv/4.0/replaceLostStolenCard
  • Auth
    none declared

Request body application/x-www-form-urlencoded

providerIdinteger required

Your unique provider identifier from SoFi Tech Solutions. Pattern: 10 digits or less Example: 9999

transactionIdstring

Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for <a href="ref:idempotency#endpoints-that-use-transactionid-for-idempotency" target="_blank">idempotency</a>. A UUID is preferred. Pattern: Maximum 60 characters Example: "9845dk-39fdk3fj3-4483483478"

apiLoginstring required

Web service username, as provided by SoFi Tech Solutions. Pattern: Max 50 characters Example: "AbC123-9999"

apiTransKeystring required

Web service password, as provided by SoFi Tech Solutions. Pattern: Max 15 characters Example: "4sb62fh6w4h7w34g"

accountNostring required

The <glossary:PRN>, <glossary:PAN> or <glossary:CAD> of the account. Pattern: PAN, PRN, or CAD Example: "999103447228"

bypassRepFee'Y' | 'N' | '' nullable

Pass Y to bypass the card replacement fee (REP). Pattern: Y or N Example: "Y"

cardStatus'L' | 'S' required

Specifies whether the card is being marked as lost (L) or stolen (S). Default: L. Pattern: L or S Example: L

cardNumberLastFourstring nullable

If multiple cards are associated with this account, use this value to ensure that the correct card is selected. Pattern: 4 digits Example: "0789"

Example request

{
  "providerId": 9999,
  "transactionId": "9845dk-39fdk3fj3-4483483478",
  "apiLogin": "AbC123-9999",
  "apiTransKey": "4sb62fh6w4h7w34g",
  "accountNo": "999103447228",
  "bypassRepFee": "Y",
  "cardStatus": "L",
  "cardNumberLastFour": "0789"
}

Response

status_codeinteger nullable required

The response status code. May return a string for some statuses.

statusstring nullable required

The condition of a process or response

processing_timenumber nullable required

The time elapsed in processing the transaction

system_timestampstring date-time nullable required

A system generated timestamp

rtokenstring nullable required

A system-generated ID used for tracking

errorsstring[]

A list of errors generated while the request was processed

Changes

No recorded changes to this operation across all 2 revisions of this API.