Replace Lost/Stolen Card

post

https://api-{corename}.{env}.gpsrv.com/intserv/4.0/replaceLostStolenCard

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 PAN, new expiry date, and new CVV for the replacement card. You must be PCI-compliant to receive the full PAN; otherwise, you will receive a masked PAN.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status code	Description
638-02	`Failure to post fees to account.`
638-03	`Card already marked lost/stolen and in progress or completed`. A replacement has already been created.
638-05	`Card Status is not valid.` Card status is `L` or `S` already.
638-06	`Invalid card type.` Card is a virtual card, which is not supported.

Form Data

providerId

integer

required

Galileo issued unique Provider identifier.
Pattern: 10 digits or less
Example: 9999

transactionId

string

length between 1 and 60

A unique system generated ID number that identifies the API transaction with Galileo Processing systems. A UUID is preferred. This must be different for each transaction.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

apiLogin

string

required

Provider's web service username, as provided by Galileo for the requesting IP address.
Pattern: Max 50 characters
Example: "AbC123-9999"

apiTransKey

string

required

Web service password, as provided by Galileo for the requesting IP address.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

accountNo

string

required

length ≥ 1

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

bypassRepFee

string | null

enum

Defaults to N

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

Allowed:

cardStatus

string

enum

required

length ≥ 1

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

Allowed:

cardNumberLastFour

string | null

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

Headers

response-content-type

string

enum

Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

Language

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml

Status codes

default