getAccountCards()
The getAccountCards() method returns a recordset that includes the customer's profile information and all accounts and card that associated with that customer. Sensitive parameters can be partially returned or removed by configuration based on the API consumer's needs and PCI posture.
Parameters
The parameters below can be submitted with the method. Note that some parameters are required.
Parameter Required Data type Pattern Notes Example value
transactionId Yes   String   60 characters or less   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.   9845dk-39fdk3fj3-4483483478  
accountNo Yes   String   PAN or PRN   Can be either a PAN (the 16 digit card number) or PRN (a unique 12 digit account identifier).   074103447228  
includeRelated No   Boolean   0 or 1   Default is true; 0=false, 1=true   0  
Status codes
Codes that define the status of the transaction.
Status Code description
0 Success
2 Invalid parameter(s)
12 Invalid customer account
-1 Indicates that the application record failed to update or return.
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
   <status_code>0</status_code>
   <status>Success</status>
   <system_timestamp>2011-02-07 11:52:15</system_timestamp>
   <response_data>
     <customer>
       <first_name>John</first_name>
       <middle_name>Scott</middle_name>
       <last_name>Doe</last_name>
       <address>1234 north 678 east</address>
       <address_2/>
       <city>Ember</city>
       <state>AZ</state>
       <postal_code>18702</postal_code>
       <country_code>840</country_code>
       <phone>8015554444</phone>
       <mobile_phone>8012223333</mobile_phone>
       <email>test@test.com</email>
       <ship_to_address>
         <address_1>123 Maple</address_1>
         <address_2>Apt. B</address_2>
         <city>Ember</city>
         <state>AZ</state>
         <postal_code>18702</postal_code>
         <country_code/>
       </ship_to_address>
       <express_mail>N</express_mail>
       <related_accounts>
         <related_account>
           <pmt_ref_no>074117133916</pmt_ref_no>
           <galileo_account_number>327003</galileo_account_number>
           <product_id>560</product_id>
           <active>Y</active>
           <status>N</status>
           <group_id>10</group_id>
           <application_date>2008-09-01</application_date>
           <start_date>2008-09-25</start_date>
           <bill_cycle_day>22</bill_cycle_day>
         </related_account>
         <related_account>
           <pmt_ref_no>074117133923</pmt_ref_no>
           <galileo_account_number>3270034</galileo_account_number>
           <product_id>750</product_id>
           <active>Y</active>
           <status>N</status>
           <group_id>11</group_id>
           <application_date>2008-09-01</application_date>
           <start_date>2008-09-25</start_date>
           <bill_cycle_day>22</bill_cycle_day>
         </related_account>
       </related_accounts>
       <occupation>Project Manager</occupation>
       <income_source>Project Manager</income_source>
     </customer>
     <accounts>
       <account>
         <pmt_ref_no>074117133905</pmt_ref_no>
         <galileo_account_number>327003</galileo_account_number>
         <product_id>560</product_id>
         <active>Y</active>
         <status>N</status>
         <group_id>5</group_id>
         <application_date>2008-09-01</application_date>
         <start_date>2008-09-25</start_date>
         <bill_cycle_day>5</bill_cycle_day>
         <cards>
           <card>
             <expiry_date>2009-05-15</expiry_date>
             <card_status>N</card_status>
             <card_number>0000000000000000</card_number>
             <card_id>43354</card_id>
             <external_card_id/>
             <pin_fail_count>3</pin_fail_count>
             <pin_fail_date>2008-02-02 00:00:00</pin_fail_date>
             <spend_controls>
               <available_credit>5000</available_credit>
               <single_use>Y</single_use>
               <credit_limit>5000</credit_limit>
             </spend_controls>
             <freeze_info>
               <status>Unfrozen</status>
               <start_date/>
               <end_date/>
             </freeze_info>
             <embossed_cards>
               <embossed_card>
                 <status>N</status>
                 <created_date>2009-05-01</created_date>
                 <emboss_date>2009-05-05</emboss_date>
                 <expiry_date>2009-05-22</expiry_date>
                 <shipping_type>standard</shipping_type>
               </embossed_card>
               <embossed_card>
                 <status>Y</status>
                 <created_date>2011-05-01</created_date>
                 <emboss_date>2011-05-05</emboss_date>
                 <expiry_date>2011-05-22</expiry_date>
                 <shipping_type>standard</shipping_type>
               </embossed_card>
             </embossed_cards>
           </card>
           <card>
             <expiry_date>2010-01-04</expiry_date>
             <card_status>N</card_status>
             <card_number>0000000000000000</card_number>
             <card_id>433322</card_id>
             <external_card_id/>
             <pin_fail_count>0</pin_fail_count>
             <pin_fail_date/>
             <spend_controls>
               <available_credit/>
               <single_use/>
               <credit_limit/>
             </spend_controls>
             <freeze_info>
               <status>Unfrozen</status>
               <start_date/>
               <end_date/>
             </freeze_info>
             <embossed_cards>
               <embossed_card>
                 <status>N</status>
                 <created_date>2009-12-26</created_date>
                 <emboss_date>2009-12-30</emboss_date>
                 <expiry_date>2010-01-04</expiry_date>
                 <shipping_type>standard</shipping_type>
               </embossed_card>
             </embossed_cards>
           </card>
         </cards>
       </account>
       <account>
         <pmt_ref_no>074110832115</pmt_ref_no>
         <galileo_account_number>327003</galileo_account_number>
         <product_id>647</product_id>
         <active>Y</active>
         <status>N</status>
         <group_id>6</group_id>
         <application_date>2008-09-01</application_date>
         <start_date>2008-09-25</start_date>
         <bill_cycle_day>5</bill_cycle_day>
         <cards>
           <card>
             <expiry_date>2011-12-22</expiry_date>
             <card_status>N</card_status>
             <card_number>0000000000000000</card_number>
             <card_id>43372</card_id>
             <external_card_id/>
             <pin_fail_count>0</pin_fail_count>
             <pin_fail_date/>
             <freeze_info>
               <status>Unfrozen</status>
               <start_date/>
               <end_date/>
             </freeze_info>
             <embossed_cards>
               <embossed_card>
                 <status>N</status>
                 <created_date>2011-12-01</created_date>
                 <emboss_date>2011-12-05</emboss_date>
                 <expiry_date>2011-12-22</expiry_date>
                 <shipping_type>standard</shipping_type>
               </embossed_card>
             </embossed_cards>
           </card>
         </cards>
       </account>
     </accounts>
   </response_data>
   <processing_time>0.228</processing_time>
   <echo>
     <transaction_id>12345a</transaction_id>
     <provider_transaction_id>77bb</provider_transaction_id>
     <provider_timestamp>2013-02-06 10:10:10</provider_timestamp>
   </echo>
</response>
Response Description Example value
status The condition of a process or response (such as embossed card, account, freeze, and so on). Success
status_code The status of the response. 0
system_timestamp A system generated timestamp. 2011-02-02 11:11:12
response_data A structure for the response data. It can be empty but usually will contain information. <response_data>
   <new_account>   </new_account>
</response_data>
customer A data structure that displays information on a customer. <customer>
  <first_name>John</first_name>
  <phone>8015554444</phone>
  <email>test@test.com</email>
  <ship_to_address>x</ship_to_address>
  <express_mail>N</express_mail>
nbsp; <related_accounts>
    <related_account>x</related_account>
    <related_account>x</related_account>
  </related_accounts>
  <occupation>Project Manager</occupation>
  <income_source>Project Manager</income_source>
</customer>
first_name Person first name. Jackie
middle_name A person's middle name on the account. Zelina
last_name Person last name. Vela
address_1 Street address line 1. 42325 Cypress Crt
address_2 Street address line 2. #33
city City for address information. Calgary
state The geographic state entity that is a part of the United States. NM
postal_code The zip code listed as part of a profile. 84402
country_code A country code based on the Iso3166-1 numeric standard. 124
phone The main phone number on account. 8017245521
mobile_phone The mobile phone number of a person as listed in a profile. 8017245521
email The email address on a profile. 3asdfaw3fadf@asdfasdf.com
ship_to_address A data structure that contains address information for shipping. <ship_to_address>
  <address_1>123 Maple</address_1>
  <address_2>Apt. B</address_2>
  <city>Ember</city>
  <state>AZ</state>
  <postal_code>18702</postal_code>
  <country_code/>
</ship_to_address>
express_mail Does the profile use express mail service? N
related_accounts A data structure that lists accounts related to a customer profile. <related_accounts>
<related_account>x </related_account>
</related_accounts>
related_account A data structure that displays account information. <related_account>
  <pmt_ref_no>074117133916</pmt_ref_no>
  <galileo_account_number>327003</galileo_account_number>
  <product_id>560</product_id>
  <active>Y</active>
  <status>N</status>
  <group_id>10</group_id>
  <application_date>2008-09-01</application_date>
  <start_date>2008-09-25</start_date>
  <bill_cycle_day>22</bill_cycle_day>
</related_account>
pmt_ref_no A Galileo generated account number. 008103023340
galileo_account_number Galileo generated integer account number, also known as balance ID. 1181464
product_id A unique product identifier. 525
active Indicates if an account is active or not. Y
status The condition of a process or response (such as embossed card, account, freeze, and so on). Success
group_id Integer value used for tracking the location (store, entity, etc...) where the customer was acquired. The group_id is set using the location and locationType parameters. 1
application_date The date an application was made to create an account. 2010-03-16
start_date Date the account was activated. 2010-10-01 00:00:00
bill_cycle_day Day of the month that the customer is billed (if monthly billing is applicable for the respective product). 22
occupation The occupation of a person as listed in a profile. Project Manager
income_source How the person on a profile earns income. Kroger Food and Drug
accounts Acts as a logical separator between accounts if more than one is returned. <accounts>
  <account>x</account>
</accounts>
account Acts as a logical separator to discern a specific account. <account>
  <prn>074129972795</prn>
  <prod_id>560</prod_id>
  <app_date>2011-02-04 04:27:55</app_date>
  <status>N</status>
  <active_flag>Y</active_flag>
</account>
cards A data structure that displays information for one or more cards. <cards>
  <card>x</card>
</cards>
card A data structure that displays information for a card. <cards>
  <card>  <expiry_date>2009-05-15</expiry_date>
  <card_status>N</card_status>
  <card_number>0000000000000000</card_number>
  <card_id>43354</card_id>
  <external_card_id/>
  <pin_fail_count>3</pin_fail_count>
  <pin_fail_date>2008-02-02 00:00:00</pin_fail_date>
    <spend_controls>  </spend_controls>
  </freeze_info>
  <embossed_cards>
  <embossed_card>
  </embossed_card>
  <embossed_card>
  </embossed_card>
  </embossed_cards>
</card>
amount An amount on a transaction. -5.4
auth_id Number assigned to an authorization. 37464470
card_id Unique identifier for a PAN. 12345
card_number A PAN or 16 digit card number. 123412XXXXXX1234
card_status Associated with the expiry_date, flag if a card has expired. N
embossed_cards An embossed card has imprinted or stamped payment card details that can be felt above the card's surface. Associated with an embossed status flag, created_date, emboss_date, expiry_date, and shipping_date. <embossed_cards>
 <embossed_card>x</embossed_card>
</embossed_cards>
embossed_card A data structure that displays the information associated with an embossed card. <embossed_card>
  <status>N</status>
  <created_date>2009-05-01</created_date>
  <emboss_date>2009-05-05</emboss_date>
  <expiry_date>2012-05-22</expiry_date>
  <shipping_type>standard</shipping_type>
</embossed_card>
end_date The end date of a response. 2010-11-01 23:59:59
expiry_date Expiration date of the card. 2009-05-22
external_card_id Alpha numeric partner specified external card identity. 1234567891234567891234567891234
freeze_info Associated with the Frozen status, and start and end date of a card. Frozen status=card locked out. Unfrozen status=card usable. (Freeze only affects authorization approvals). brackets here
pin_fail_count Counts the number of times a PIN entry fails. 3
pin_fail_date Date a PIN fail was recorded. 2009-05-22
timestamp The date and time a change was made. 2012-09-20 07:43:51
processing_time The time elapsed in processing the transaction. 1.723
echo A structure that displays transaction ID information. <echo>
  <transaction_id>...</transaction_id>
  <provider_transaction_id>...</provider_transaction_id>
  <provider_timestamp>...</provider_timestamp>
</echo>
transaction_id A number that represents a transaction. 12345a
provider_transaction_id Secondary transaction identifier (generated by a provider). 77bb
provider_timestamp Store a related timestamp for reporting and troubleshooting purposes. 2013-02-06 10:10:10
Code Snippet

                    # The following shell script will use cURL to call getAccountCards
# and return the json response.

curl -d '{"apiLogin":"AbC1234-9999", "apiTransKey":"9845dk-39fdk3fj3-4483483478", "transactionId":"45k-dk3fj3-44478"}' \ 
-H "response-content-type: json" \ 
-X POST https://**your-full-implementation-url**/getAccountCards
                
                    // The following Java code will make a getAccountCards call
// and print the json response.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.Reader;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLEncoder;
import java.util. *;

class GalileoAPICall
{
    public static void main(String[] args) {
        try {
            Map<String,Object> params = new LinkedHashMap<>();
           params.put("apiLogin", "AbC1234-9999");
           params.put("apiTransKey", "9845dk-39fdk3fj3-4483483478");
           params.put("transactionId", "45k-dk3fj3-44478");
            StringBuilder postData = new StringBuilder();
            for (Map.Entry<String,Object> param : params.entrySet()) {
                if (postData.length() != 0) postData.append('&');
                postData.append(URLEncoder.encode(param.getKey(), "UTF-8"));
                postData.append('=');
                postData.append(URLEncoder.encode(String.valueOf(param.getValue()), "UTF-8"));
            }
            byte[] postDataBytes = postData.toString().getBytes("UTF-8");

            URL url = new URL("https://**your-full-implementation-url**/getAccountCards");

            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("response-content-type", "json");
            conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
            conn.setDoOutput(true);
            conn.getOutputStream().write(postDataBytes);

            String xmlOutput;

            Reader in = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
            for (int c; (c = in.read()) >= 0;) {
                System.out.print((char)c);
            }
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
                
                    # The following Python code will call getAccountCards
# and print the json response.

import requests
headers = {'response-content-type': 'json'}
payload = {'apiLogin': 'AbC1234-9999', 'apiTransKey': '9845dk-39fdk3fj3-4483483478', 'transactionId': '45k-dk3fj3-44478'}
r = requests.post(url='https://**your-full-implementation-url**/getAccountCards', data=payload, headers=headers)
try:
    print(r.json())
except:
    print(r.status_code)
                
                    // The following PHP code will make a getAccountCards call
// and prints the json response.

$endpoint = 'https://**your-full-implementation-url**/getAccountCards';
$params = array('apiLogin'=>'AbC1234-9999', 'apiTransKey'=>'9845dk-39fdk3fj3-4483483478', 'transactionId'=>'45k-dk3fj3-44478');

$curl = curl_init();
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $params);
curl_setopt($curl, CURLOPT_URL, $endpoint);
curl_setopt($curl, CURLOPT_HTTPHEADER, array('response-content-type: json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);

$result = curl_exec($curl);
curl_close($curl);
$json = new json_decode($result, true);
print_r($json);

                
                    // The following C# code will make a getAccountCards call
// and print the json response.

using System;using System.IO;
using System.Net;
using System.Text;

byte[] data = Encoding.ASCII.GetBytes(
    "apiLogin=AbC1234-9999&apiTransKey=9845dk-39fdk3fj3-4483483478&transactionId=45k-dk3fj3-44478");
WebRequest request = WebRequest.Create("https://**your-full-implementation-url**/getAccountCards");
request.Method = "POST"\;
request.ContentLength = data.Length;
request.Headers.Add("response-content-type", "json");
using (Stream stream = request.GetRequestStream())
{
    stream.Write(data, 0, data.Length);
}
string responseContent = null;
using (WebResponse response = request.GetResponse())
{
    using (Stream stream = response.GetResponseStream())
    {
        using (StreamReader sr = new StreamReader(stream))
        {
            responseContent = sr.ReadToEnd();
        }
    }
}
Console.WriteLine(responseContent);
                
                    # The following Ruby code will make a getAccountCards call
# and print the json response.

require 'uri'
require 'net/http'

uri = URI("https://**your-full-implementation-url**/getAccountCards")
https = Net::HTTP.new(uri.host, uri.port)
https.use_ssl = true
request = Net::HTTP::Post.new(uri.path)
request['response-content-type'] = 'json'
request.body = {apiLogin: 'AbC1234-9999', apiTransKey: '9845dk-39fdk3fj3-4483483478', transactionId: '45k-dk3fj3-44478'}.to_json
response = https.request(request)
puts response