Use the Create Virtual Card Account endpoint to create a virtual card account for a new customer. To create any other type of account for a new customer use the Create Account endpoint.
Create Virtual Account is similar to Create Account except that it accepts only virtual card product IDs for prodId. Consult the Creating an Account procedure for instructions on using this endpoint, and consult the Customer ID Verification guide for how to use this endpoint with Galileo's integrated CIP solution.
Note
You must be PCI-compliant to use this endpoint. If you are not PCI compliant, use the Create Account endpoint and specify a virtual card product for
prodId.
Note
If this endpoint returns a status code that does not match a status code that is specific to this endpoint, it may be an enrollment status code. See Enrollment Statuses for more information.
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 |
|---|---|
| 520-01 | Load amount outside of load limits. Retry with loadAmount within load limits for this prod_id. |
| 520-02 | Could not create enrollment. Failed to create the customer record. Contact Galileo for troublshooting. |
| 520-03 | Could not load card. Card load failed. Contact Galileo for troubleshooting |
| 520-04 | Account created, ID Validation failed. Customer's personal info has failed the ID check. Take action depending on the result in the response: F — Fail. Take no action: the customer does not qualify for an account.R — Refer. Depending on your arrangements with Galileo, request valid documents from the customer or wait for Galileo's third-party CIP to complete. |
| 520-05 | Specified load from account number is invalid. The funding account to load this prod_id is not properly set up. |
| 520-06 | A load was attempted for a non-positive amount. Retry with a positive value for loadAmount. |
| 520-07 | Primary account is invalid. Retry with a valid number for primaryAccount. |
| 520-08 | Secondary accounts cannot be added. Product parameters do not permit the prodId to be a secondary account for the account in primaryAccount. Check SECP on the primary account. |
| 520-09 | Maximum number of secondary accounts exceeded. To increase the secondary account limit per product ID, set SECLM on the secondary account. |
| 520-10 | ID type 2 is required as main ID for running CIP. Product settings require idType: 2 (SSN/SIN) to run Galileo's integrated customer ID verification. Pass a SSN in id. Controlled by VLDLV. |
| 520-12 | An application with the same ID has already been submitted. Duplicate SSNs were used for enrollment. Follow your business plan for this outcome. Controlled by VLDLV. |
| 520-14 | Success - partial limit violation. Only the amount permitted by project settings was loaded. |
| 520-15 | Success - delayed payment. The account was created but funds were not loaded onto the card because of limit violations. An attempt will be made tomorrow to load the card. |