Create Virtual Card Account

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 codeDescription
520-01Load amount outside of load limits. Retry with loadAmount within load limits for this prod_id.
520-02Could not create enrollment. Failed to create the customer record. Contact Galileo for troublshooting.
520-03Could not load card. Card load failed. Contact Galileo for troubleshooting
520-04Account 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-05Specified load from account number is invalid. The funding account to load this prod_id is not properly set up.
    520-06A load was attempted for a non-positive amount. Retry with a positive value for loadAmount.
    520-07Primary account is invalid. Retry with a valid number for primaryAccount.
    520-08Secondary 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-09Maximum number of secondary accounts exceeded. To increase the secondary account limit per product ID, set SECLM on the secondary account.
    520-10ID 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-12An 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-14Success - partial limit violation. Only the amount permitted by project settings was loaded.
    520-15Success - 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.
    Language
    Click Try It! to start a request and see the response here!