This guide describes the endpoints and procedures for implementing Galileo Secured Credit.
## Endpoints for Galileo Secured Credit
This table lists actions for creating and managing secured credit products at Galileo, and related Program API endpoints. Guides provide additional information and procedures.
Note
Endpoints listed here are not exclusive to secured credit products. The same endpoints are used across Galileo products.
Action | Endpoint(s) | Guide(s) |
Create the primary account, charge card account, and secured credit account | <a href="ref:post_createaccount" target="_blank">Create Account</a><br><a href="ref:post_addaccount" target="_blank">Add Account</a> | <a href="doc:create-account-procedure" target="_blank">Creating an Account</a> |
Activate the charge card | <a href="ref:post_activatecard" target="_blank">Activate Card</a> | <a href="doc:about-cards" target="_blank">About Cards</a><br><a href="doc:activate-card-procedure" target="_blank">Activating a Card</a> |
Move funds into the secured credit account | <a href="ref:post_createaccounttransfer" target="_blank">Create Account Transfer</a> | <a href="doc:creating-an-internal-transfer" target="_blank">Creating an Internal Transfer</a> |
Move funds out of the secured credit account | <a href="ref:post_createadjustment" target="_blank">Create Adjustment</a><br><a href="ref:post_createpayment" target="_blank">Create Payment</a> | <a href="doc:about-adjustments" target="_blank">Creating an Adjustment</a><br><a href="doc:creating-a-payment" target="_blank">Creating a Payment</a> |
Update the credit limit when the secured credit account balance changes | <a href="ref:post_setcreditlimit" target="_blank">Set Credit Limit</a> | |
Change account or card status | <a href="ref:post_modifystatus" target="_blank">Modify Status</a> | <a href="doc:about-accounts#account-status" target="_blank">Account status</a> in _About Accounts_<br><a href="doc:about-cards#card-statuses" target="_blank">Card statuses</a> in _About Cards_ |
Report account closure status | <a href="ref:post_modifystatus" target="_blank">Modify Status</a> | <a href="doc:setting-up-secured-credit#account-closure-status-reporting" target="_blank">Account closure status reporting</a> in _Setting Up Secured Credit_<br><a href="doc:developer-setup-for-secured-credit#reporting-account-closure-status" target="_blank">Reporting account closure status</a> in _Developer Setup for Secured Credit_ |
Get account and card information | <a href="ref:post_getaccountoverview" target="_blank">Get Account Overview</a><br><a href="ref:post_getcard" target="_blank">Get Card</a> | <a href="doc:about-accounts#retrieving-account-information" target="_blank">Retrieving account information</a> in _About Accounts_<br><a href="doc:about-cards#viewing-card-information" target="_blank">Viewing card information</a> in _About Cards_ |
View credit history | <a href="ref:post_getcreditsummary" target="_blank">Get Credit Summary</a><br><a href="ref:post_getcreditlimitchangehistory" target="_blank">Get Credit Limit Change History</a> | |
Charge off an unpaid account. If Galileo handles your credit reporting, the charge-off is included in the report. | <a href="ref:post_chargeoffaccount" target="_blank">Charge Off Account</a> | Related to <a href="doc:setting-up-secured-credit#account-closure-status-reporting" target="_blank">Account closure status reporting</a> |
## Creating secured credit accounts for a new or existing customer
Secured credit requires three accounts: a primary account, a charge card account, and secured credit account. This section describes how to set up each account. For an example account creation workflow, see <a href="doc:secured-credit-workflows#secured-credit-account-structure" target="_blank">Secured credit account structure</a> under _Secured Credit Workflows_.
### Primary account
The primary account for a secured credit product can be a <<glossary:DDA>> or another type of account capable of holding and transferring funds. Existing customers will already have this account. When you create the primary account for a new customer, follow the normal onboarding procedure as described in the <a href="doc:create-account-procedure" target="_blank">Creating an Account</a> guide.
If you are setting up secured credit for an existing customer, and the primary account has a debit card linked to it, you may decide to deactivate the existing debit card depending on your business plan. For a <<glossary:DDA>>, see [Canceling the DDA debit card](🔗) in this guide.
If you are setting up secured credit for a new customer, you do not need to create a debit card linked to the primary account.
Pass e-sign verification information to Galileo via <a href="ref:post_setaccountfeature" target="_blank">Set Account Feature</a>. Send `
featureType: 19
` (E-sign Act opt-in) and the appropriate `featureValue
` (set to `Y
` to receive electronic letters).
Depending on your internal setup, you may require the cardholder to deposit funds into the primary account either before the secured credit account is created, or after all three accounts are created. The primary account must contain funds before you can establish a credit line with the secured account.
### Charge card account
The charge card account links to the credit card and gives the cardholder access to the credit line. To create a new charge card account for an existing customer, send an <a href="ref:post_addaccount" target="_blank">Add Account</a> request. This table describes parameters that are specific to creating a new charge card account.
Parameter | Description |
`prodId ` | Product ID for the charge card product |
`primaryAccount ` | PRN for the primary account |
### Collateral account
The secured credit account contains the collateral funds for the credit line. You set the credit line according to the amount in this account. To create a new secured credit account for an existing customer, send an <a href="ref:post_addaccount" target="_blank">Add Account</a> request. This table describes parameters that are specific to creating a new secured credit account.
Parameter | Description |
`prodId ` | Product ID for the charge card product |
`primaryAccount ` | PRN for the primary account |
## Implementing billing cycles
The customer’s billing cycle is implemented when an account is created with the <a href="ref:post_createaccount" target="_blank">Create Account</a>, <a href="ref:post_addaccount" target="_blank">Add Account</a>, or <a href="ref:post_createvirtualcard" target="_blank">Create Virtual Card Account</a> endpoint. When you send a request to one of these endpoints, the billing cycle day will be returned in the `billing_cycle_day
` field as a value within the range of 1–28.
The billing cycle date is dependent on the value in BRCDT, which is set during product configuration. See <a href="doc:setting-up-galileo-secured-credit#billing-cycles" target="blank">Billing cycles</a> in _Setup for Galileo Secured Credit guide_ for a description of each configuration.
## Canceling the DDA debit card
When you set up Galileo Secured Credit for an existing cardholder, you may decide to cancel the <<glossary:DDA>> debit card at the time that the charge card is activated. Keep in mind that virtual cards are automatically activated. See <a href="doc:setting-up-a-card-program#card-cancelation" target="_blank">Card cancelation</a> in the _Setting Up a Card Program_ guide for more information.
## Setting the credit line
After the secured credit account is created, follow these steps to set the credit line:
Send the <a href="ref:post_createaccounttransfer" target="_blank">Create Account Transfer</a> request to move funds from the primary account into the secured account.
Send the <a href="ref:post_setcreditlimit" target="_blank">Set Credit Limit</a> request to adjust the credit line.
## Reporting account closure status
When a secured credit account closes, you can send the account closure status to Galileo. If Galileo handles your credit reporting, this status will be included in the report. For an overview of account closure status reporting for secured credit products, see <a href="doc:setting-up-secured-credit#account-closure-status-reporting" target="_blank">Account closure status reporting</a> under _Setting Up Secured Credit_.
To report account closure status, send a <a href="ref:post_modifystatus" target="_blank">Modify Status</a> request with the following parameters:
Parameter | Value |
`accountNo ` | The primary account number for the secured credit product |
`type ` | Valid types are `2 `, `13 `, `16 `, and `20 ` |
`closureReason ` | One of the values listed in the table below |
This table lists possible values for `closureReason
`.
Value | Description |
`chargeoff ` | Account is unpaid, closed by the issuer, and charged off |
`collection ` | Account is unpaid, closed by the issuer, and is in internal collections |
`deleted_fraud ` | Account takeover fraud, account closed by the issuer |
`inactivity ` | Account is paid and closed by the issuer due to inactivity |
`paid_user ` | Account is paid and closed at the customer’s request |