Creating Corporate Credit Limit Accounts

This guide explains how to use the Create Account endpoint to set up Corporate Credit Limit funding and spending accounts. Along with this guide, you might want to read these other guides:

Create a Corporate Credit Limit funding account

To create a Corporate Credit Limit (CCL) funding account, call the Create Account endpoint. Do not use any other endpoint. Go to Creating an Account for general instructions on populating the call and consult the table below for information specific to corporate credit limit accounts.

ParameterValue
Name parametersOptional. You can provide a user-friendly name for the account. Galileo will not validate these values.
Address parametersOptional. You can provide an address for your own accounting purposes. Galileo will not validate these values.
prodIdRequired. ID of a Corporate Credit Limit funding product
externalAccountIdOptional. A user-provided, alternative identifier for this account. Galileo will not validate this value.

A CCL funding account must be in status: N to fund CCL spending accounts. However, the non-active statuses may permit ACH transfers and manual adjustments into or out of the CCL funding account. Consult Account Statuses to see what each status permits.

Set the credit limit on a funding account

To set the credit limit on the CCL funding account, call Set Corporate Credit Limit with these parameters:

ParameterValue
accountNopmt_ref_no of the CCL funding account
amountamount of the limit

When you want to change the credit limit on the funding account, use this same endpoint.

Create a Corporate Credit Limit spending account

You have these options for creating a CCL spending account:

ParameterValue
Name parametersRequired. Provide the name of the person to whom the card will be issued. This name will be printed on the card.
prodIdRequired. ID of a CCL spending product.
externalAccountIdOptional. A user-provided, alternative identifier for the account.
embossLine2Optional. Text to be printed under the cardholder name, such as the company name.
fundingAccountNoRequired. The PRN of the CCL funding account. This value cannot be changed after it is set.

Managing Corporate Credit Limit

Although CCL accounts have many similarities with conventional accounts, there are some differences, as shown in the sections below.

Viewing Corporate Credit Limit accounts

When you create a CCL funding account or a CCL spending account, that account will be included in the Customer Master RDF. Only the spending account is included in the Account Card RDF. However, there is no field in those RDFs to link the spending and funding accounts.

To see which CCL funding account is associated with a CCL spending account, you have these options:

  • Retrieve the funding account's PRN with the Get RTF Account Relationship endpoint.
  • Capture the funding account's PRN in the fund_pmt_ref_no field in Events API webhook messages.
  • Consume the B2B Customer Master Supplemental CDF, which lists each CCL spending account and shows the CCL funding account that it is associated with.

To see which CCL spending accounts are associated with a CCL funding account, you can either:

  • Use the Get RTF Account Relationship endpoint.
  • In the CST, on the CCL funding account page, at the bottom of the left navigation, expand the Corporate Credit tab and select Related Spending Accounts.

To check the credit limit or balance of a CCL funding account, you can:

  • Capture the fund_pastotb value in the Events API webhook messages. This field shows the balance on the funding account.
  • View the remaining limit on the CCL funding account's landing page in the CST.
  • Call the Get Corporate Credit Summary endpoint with the PRN of the CCL funding account as the accountNo. This endpoint retrieves both the balance and the available credit.

Viewing Corporate Credit Limit transactions

To identify the transfers between the CCL funding account and CCL spending accounts, Galileo has created these otypes (transaction types). All transfers are adjustments (act_type: AD). The type (otype) and type_description fields in the table below are from the Get All Transaction History endpoint response.

typetype_descriptionDescription
FYRTF Auth Funding Account TransferFunding account transfer into the spending account at the time of authorization
SYRTF Auth Spending Account TransferSpending account transfer from the funding account at the time of authorization
FZRTF Funding Account TransferFunding account transfer into the spending account at a time other than authorization. This code may indicate either a credit or a debit to the funding account
SZRTF Spending Account TransferSpending account transfer from the funding account at a time other than authorization. This code may indicate either a credit or a debit to the spending account.

The CCL funding transactions are visible as follows:

Paying off Corporate Credit Limit balances

When paying off the balance of a CCL funding account, you must move actual funds into the account. You can use any of these methods:

  • Move funds into the funding account using ACH.
    • To initiate transfers from the external account, use the funding account's routing number and PRN to set up the ACH credit.
    • To pull funds from the external account, add an ACH account using the funding account PRN for accountNo. Depending on the type of external account, you can create a corporate ACH account or a regular (personal) ACH account.
    • Use Create ACH Transaction to create an ACH debit. The transfer could take 2–3 days.
  • Transfer funds from another account in your program using the Program API. In cooperation with Galileo, you should create a special otype (transaction type) for transfers into a CCL funding account.

Setting authorization limits on Corporate Credit Limit accounts

When you set up your CCL spending product, you set velocity limits for the product (amount per transaction, amount per week) as well as MCC and merchant ID limits. To set these same limits on a per-account basis, use Galileo's Account-Level Authorization Controls.

On the CCL funding product you can set up limits for ACH and Program API transfers.

Adjusting spending account balances

The Galileo system is designed to automatically move funds between the CCL spending account and the CCL funding account. However, in some rare cases, it is possible that a non-zero balance remains in the CCL spending account.

To adjust the CCL spending account back to zero, use the Create Adjustment endpoint with includeRtfTransfer: 0 so that the CCL funding account is not affected. You may want to request that Galileo create a type that indicates a purely administrative adjustment, or you can choose from among the otypes that you already have.

Closing a corporate credit spending account

You can close a CCL spending account the same way that you close a conventional card account, using Modify Status. If you select a type that closes related accounts, the CCL funding account is not affected.

Closing a corporate credit funding account

When you close a CCL funding account, all of the associated CCL spending accounts become unusable—all authorization requests are denied because the cards have no available credit by themselves.

🚧

Warning

You cannot migrate CCL spending accounts to a different CCL funding account.

To close a CCL funding account, call Modify Status with the desired type:

  • 2 — Change status to D (deactivated)
  • 13 — Change status to C (canceled)
  • 16 or 20 — Change status to Z (canceled without refund)

Events API

The same Authorization Events and Settlement Event webhooks are sent for the CCL spending account transactions as for conventional transactions, such as BAUT: auth, DAUT: denied_auth, and SETL: setl.

However, you will have new fields enabled for those messages:

  • fund_pastotb_adj — The available balance in the funding account, after the current transaction has taken place. This field is not available for denied authorizations.
  • fund_pmt_ref_no — The PRN of the CCL funding account that is associated with the CCL spending account.

No event webhooks are sent for the transfers between the CCL funding account and the CCL spending accounts.

Corporate Credit Limit accounts and other Program API endpoints

The behavior of some other Program API endpoints is slightly different with CCL accounts:

  • Get Related Accounts — Cannot be used to show the relationships between CCL funding and CCL spending accounts; instead, use Get RTF Account Relationship.
  • Add Account — Cannot be used to create a CCL funding account. Can be used to create a CCL spending account or to add accounts to a CCL spending account, but the balance cannot be shared.
  • Switch Product — The prodId must be another product of the same type, so a CCL funding account can be switched to another CCL funding product. If an invalid switch is attempted, the endpoint returns status_code: 590-02 (Product cannot be switched to an unauthorized product).
  • Add Card — Cannot be used to add cards to a CCL funding account. Can be used to add a card to a CCL spending account.
  • Modify Status — Some of the values of type have different behavior with CCL accounts:
    • A type such as 2, 13, 16 or 20 cancels a card and/or its account, plus related accounts. When a CCL spending account is canceled in this manner, the CCL funding account is not affected.
    • A type that affects cards, such as reissue, freeze/unfreeze or lost/stolen, cannot be used on CCL funding accounts.
  • Get Account Overview, Get Transaction History — For a CCL spending account, only the authorizations and settlements are returned, as well as conventional payments and adjustments. The CCL funding transactions are not returned. For a CCL funding account, all of the funding transfers (FY, FZ) are returned as well as other payments and adjustments.
  • Get All Transaction History — For a CCL funding account all funding transfers (FY, FZ) are returned as well as other payments and adjustments. For a CCL spending account, all transactions including the funding transfers (SY, SZ) are returned.
    • For all three transaction-retrieval endpoints there is a custom field in the response, depending on whether the accountNo is a CCL funding or CCL spending account:
      • spending_account_prn — Contains the PRN of the associated CCL spending account for FY and FZ transactions.
      • funding_account_prn — Contains the PRN of the associated CCL funding account for SY and SZ transactions.