Corporate Credit Endpoint Reference
Use the Corporate Credit (CC) endpoints to set and retrieve credit limits on a CC funding account, as well as determine whether an account is a CC funding or spending account.
- Set Corporate Credit Limit
- Get Corporate Credit Summary
- Get Corporate Credit Change History
- Is Corporate Credit Funding Account
- Is Corporate Credit Spending Account
Universal parameters
All Program API endpoints must include these parameters:
| Parameter | Req | Data type | Description | Pattern | Example |
|---|---|---|---|---|---|
apiLogin | X | string | Provider’s web service username as provided and authenticated by Galileo for the requesting IP address. | Max 50 characters | "AbC123-9999" |
apiTransKey | X | string | Web service password as provided and authenticated by Galileo for the requesting IP address. | Max 15 characters | "4sb62fh6w4h7w34g" |
providerId | X | int32 | Galileo-issued unique provider identifier. | Max 10 digits | 9999 |
transactionId | X | string | 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. | Max 60 characters | "9845dk-39fdk3fj3-4483483478" |
POST Set Corporate Credit Limit
/setCorporateCreditLimit
Use the Set Corporate Credit Limit endpoint to set a credit limit on a CC funding account. A valid CC funding product is in product category 32. As desired, set LIMMX and LIMMN product parameters to control maximum and minimum amounts to set.
All endpoint requests must pass the universal parameters. This endpoint also includes these parameters:
| Parameter | Req | Data type | Description | Pattern | Example |
|---|---|---|---|---|---|
accountNo | X | string | PRN of a CC funding account. Funding accounts do not have a PAN or CAD. | PRN | "999103447228" |
amount | X | float | Currency amount as a whole or decimal amount. | Positive integer or decimal number | 100.00, 100, or 100.73 |
Sample request
curl --location --request POST 'https://[URL]/intserv/4.0/setCorporateCreditLimit' \
--header 'response-content-type: json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'apiLogin=[redacted]' \
--data-urlencode 'apiTransKey=[redacted]' \
--data-urlencode 'providerId=19' \
--data-urlencode 'transactionId=80b94f05-23b1-41af-b2bb-fe52ab68f0e0' \
--data-urlencode 'accountNo=999102163165' \
--data-urlencode 'amount=5000'
Sample response
{
"status_code": 0,
"status": "Success",
"processing_time": 0.081,
"response_data": {
"new_credit_limit": "5000.00",
"available_balance": "4150.27"
},
"echo": {
"transaction_id": "9845dk-39fdk3fj3-4483483478"
},
"rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
"system_timestamp": "2023-07-13 10:38:13"
}
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 |
|---|---|
| 1209-01 | The account provided is not a valid CC funding account. The prod_cat must be 32. |
| 1209-02 | Invalid credit limit or new credit limit is out of range |
POST Get Corporate Credit Summary
/getCorporateCreditSummary
Use the Get Corporate Credit Summary endpoint to retrieve the credit limit on the CC funding account as well as how much of the credit limit is still available to spend. Pass a CC funding account (product category 32) for accountNo.
All endpoint requests must pass the universal parameters. This endpoint also includes these parameters:
| Parameter | Req | Data type | Description | Pattern | Example |
|---|---|---|---|---|---|
accountNo | X | string | PRN of a Corporate Credit funding account. Funding accounts do not have a PAN or CAD. | PRN | "999103447228" |
Sample request
curl --location --request POST 'https://[URL]/intserv/4.0/getCorporateCreditSummary' \
--header 'response-content-type: json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'apiLogin=[redacted]' \
--data-urlencode 'apiTransKey=[redacted]' \
--data-urlencode 'providerId=19' \
--data-urlencode 'transactionId=92a84746-06e3-4aa5-b14b-51fe1be21e99' \
--data-urlencode 'accountNo=999102163165'
Sample response
{
"status_code": 0,
"status": "Success",
"processing_time": 0.081,
"response_data": {
"credit_limit": "5000.00",
"available_balance": "4150.27"
},
"echo": {
"transaction_id": "9845dk-39fdk3fj3-4483483478"
},
"rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
"system_timestamp": "2023-07-13 10:38:13"
}
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 |
|---|---|
| 1210-01 | Invalid CC funding account |
POST Get Corporate Credit Change History
/getCorporateCreditChangeHistory
Use the Get Corporate Credit Change History endpoint to retrieve a history of changes to the credit limit for the specified CC funding account. Pass a CC funding account (product category 32) for accountNo.
All endpoint requests must pass the universal parameters. This endpoint also includes these parameters:
| Parameter | Req | Data type | Description | Pattern | Example |
|---|---|---|---|---|---|
accountNo | X | string | PRN of a CC funding account. Funding accounts do not have a PAN or CAD. | PRN | "999103447228" |
Sample request
curl --location --request POST 'https://[URL]/intserv/4.0/getCorporateCreditChangeHistory' \
--header 'response-content-type: json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'apiLogin=[redacted]' \
--data-urlencode 'apiTransKey=[redacted]' \
--data-urlencode 'providerId=19' \
--data-urlencode 'transactionId=92a84746-06e3-4aa5-b14b-51fe1be21e99' \
--data-urlencode 'accountNo=999102163165'
Sample response
{
"status_code": 0,
"status": "Success",
"processing_time": 0.081,
"response_data": {
"total_record_account": 3,
"changes": [
{
"timestamp": "2023-07-13 14:23:40",
"credit_limit": "2500",
},
{
"timestamp": "2023-07-12 14:23:40",
"credit_limit": "2000"
},
{
"timestamp": "2023-07-11 14:23:40",
"credit_limit": "1500"
}
]
},
"echo": {
"transaction_id": "9845dk-39fdk3fj3-4483483478"
},
"rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
"system_timestamp": "2023-07-13 10:38:13"}
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 |
|---|---|
| 1211-01 | Invalid CC funding account |
POST Is Corporate Credit Funding Account
/isCorpCreditFundingAccount
Use the Is Corporate Credit Funding Account endpoint to determine whether the specified account is a CC funding account. A CC funding account is in product category 32.
All endpoint requests must pass the universal parameters. This endpoint also includes these parameters:
| Parameter | Req | Data type | Description | Pattern | Example |
|---|---|---|---|---|---|
accountNo | X | string | PRN of a corporate credit funding account. Funding accounts do not have a PAN or CAD. | PRN | "999103447228" |
Sample request
curl --location --request POST 'https://[URL]/intserv/4.0/isCorpCreditFundingAccount' \
--header 'response-content-type: json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'apiLogin=[redacted]' \
--data-urlencode 'apiTransKey=[redacted]' \
--data-urlencode 'providerId=19' \
--data-urlencode 'transactionId=92a84746-06e3-4aa5-b14b-51fe1be21e99' \
--data-urlencode 'accountNo=999102163165'
Sample response
{
"status_code": 0,
"status": "Success",
"processing_time": 0.081,
"response_data": {
"result": "true"
},
"echo": {
"transaction_id": "9845dk-39fdk3fj3-4483483478"
},
"rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
"system_timestamp": "2023-07-13 10:38:13"
}
Status codes
See Global Response Statuses for status codes that are common across endpoints. There are no status codes specific to this endpoint.
Back to top
POST Is Corporate Credit Spending Account
/isCorpCreditSpendingAccount
Use the Is Corporate Credit Spending Account endpoint to determine whether the specified account is a CC spending account. A CC spending account is in product category 32.
All endpoint requests must pass the universal parameters. This endpoint also includes these parameters:
| Parameter | Req | Data type | Description | Pattern | Example |
|---|---|---|---|---|---|
accountNo | X | string | The PRN, PAN or CAD of the account. Do not use the PRN if more than one card has ever been associated with this account. | PRN, PAN, CAD | "999103447228" |
Sample request
curl --location --request POST 'https://[URL]/intserv/4.0/isCorpCreditSpendingAccount' \
--header 'response-content-type: json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'apiLogin=[redacted]' \
--data-urlencode 'apiTransKey=[redacted]' \
--data-urlencode 'providerId=19' \
--data-urlencode 'transactionId=92a84746-06e3-4aa5-b14b-51fe1be21e99' \
--data-urlencode 'accountNo=999102163165'
Sample response
{
"status_code": 0,
"status": "Success",
"processing_time": 0.081,
"response_data": {
"result": "false"
},
"echo": {
"transaction_id": "9845dk-39fdk3fj3-4483483478"
},
"rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
"system_timestamp": "2023-07-13 10:38:13"
}
Status codes
See Global Response Statuses for status codes that are common across endpoints. There are no status codes specific to this endpoint.
Back to top