February 2022

In February 2022 we corrected some parameters, added new events, updated endpoint parameter descriptions, clarified a status code, clarified the guide on secured credit, added new status codes, corrected information about secondary accounts, clarified disqualifying overdraft events, added information about driving accounts negative, added new STIP fields, clarified endpoint descriptions, clarified an event trigger, added our breaking-change policy, clarified the PIN-set events, updated how to use the id and id2 parameters and removed an erroneous statement about the Pulse network. Click February 2022 to see the details.

CIP product parameters

In the Galileo setup section of the Customer ID Verification (KYC/CIP) guide, the description for the VALID parameter was incorrect, and the VLDLV parameter was missing.

CLIM event

We added a new Account Event, CLIM: credit_limit_change, which is triggered when the limit on a credit account changes.

Endpoint parameter clarifications

We clarified the descriptions for the following endpoint parameters:

  • Switch Product and Reissue Card — For the oldCardStatus parameter, the default is blank. Clarified description and examples for newPan, emboss, and newExpiryDate parameters.
  • Expire Hold — Leave expirationDateTime empty to expire the hold immediately.
  • Modify Status — The bypassRepFee parameter is only valid when type: 19.
  • Get Fee History, Get Pending Fees, and Assess Fee — The type field is the three-letter fee code, not the transaction type (otype).

Status code clarification

We clarified the descriptions for Expire Hold status codes. 540-02 can be resolved with a future date-time or by leaving expirationDateTime empty. 540-03 does not apply to new holds; removed “when creating a hold” from the description.

Secured credit clarification

We updated the Secured Credit guide with information about customer benefits and made clarifications about the customer experience. We also added some new use cases and added a new section on program manager responsibilities.

New status codes

The Switch Product endpoint has new status codes: 590-03 through 590-12.

Secondary accounts

The About Accounts guide stated that secondary accounts cannot be used as primary accounts. This is no longer true. A secondary account number can be used for accountNo with Add Account. A secondary account number still cannot be used for primaryAccount with Create Account.

Disqualifying overdraft account events

To the Managing Overdraft Accounts guide we added details about what causes an account holder to lose access to overdraft and how to restore access.

Driving accounts negative

To the description for the Create Account Transfer endpoint we added a note about setting the ALWNB parameter to allow the endpoint to drive the sending account negative.

New event

We added a new Account Event, ACST: account_status_change, which is triggered when an account changes to a status that is specified in the ACMSG product parameter.

STIP-related fields

When Mastercard performs STIP, Galileo can include the response code that Mastercard sent to the merchant in the in_de39 field in the STPD: auth_stip_info Authorization Event message and in the RDFs. These fields are enabled by request.

Endpoint description clarifications

We updated the following endpoint descriptions:

CRCA event

We clarified the trigger for the CRCA: ready_to_activate event, which is when a card is activated in the CST. The ready_to_activate name is a misnomer, because the card is already active when the event is sent.

Breaking-change policy

We added our Breaking Change Policy to indicate which types of changes are to be communicated in advance of the change going live.

PIN-set events

We clarified the event triggers for the PIN-set events:

Using the id and id2 fields

In the Customer ID Verification (KYC/CIP) guide, we clarified how to use the id and id2 parameters in the enrollment endpoints.

Pulse as a secondary network.

The Networks guide had formerly indicated that Pulse was not supported as a secondary network. That is no longer true: Pulse is now supported as a secondary.