curl -X GET https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6 \
-u "YOUR_UUID:YOUR_SECRET" \
-H "X-API-Version: 1.2" \
-H "Content-Type: application/json"
const response = await fetch("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6", {
method: "GET",
headers: {
Authorization: "Basic " + Buffer.from("YOUR_UUID:YOUR_SECRET").toString("base64"),
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
"https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6",
auth=("YOUR_UUID", "YOUR_SECRET"),
headers={
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6")
request = Net::HTTP::Get.new(uri)
request.basic_auth("YOUR_UUID", "YOUR_SECRET")
request["X-API-Version"] = "1.2"
request["Content-Type"] = "application/json"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)
<?php
$ch = curl_init("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_USERPWD => "YOUR_UUID:YOUR_SECRET",
CURLOPT_HTTPHEADER => [
"X-API-Version: 1.2",
"Content-Type: application/json",
],
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Example {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString("YOUR_UUID:YOUR_SECRET".getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6"))
.header("Authorization", "Basic " + credentials)
.header("X-API-Version", "1.2")
.header("Content-Type", "application/json")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth("YOUR_UUID", "YOUR_SECRET")
req.Header.Set("X-API-Version", "1.2")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_UUID:YOUR_SECRET")));
request.Headers.Add("X-API-Version", "1.2");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"message": "Card found successfully",
"card_details": {
"id": "cst_hkdmt2bxdh5enk6uxs0",
"request_id": "5ff52ab4-1f6c-4dd3-9f43-4ee0a20f0f24",
"customer_id": "cus_hkdmn5lcqh5enc37sp6",
"payment_method": {
"type": "card",
"id": "mtd_hkdmn5lcqh5enk7388n",
"card": {
"expiry_month": "12",
"expiry_year": "2026",
"name": "",
"bin": "40120003",
"last4": "1003",
"brand": "visa",
"issuer_country_code": "RU",
"card_type": "CREDIT",
"fingerprint": "4yOwItYXF79ScJEtmG+qW42QuU0=",
"issuer_name": "VISA PRODUCTION SUPPORT CLIENT BID 1",
"is_commercial": false,
"number_type": "PAN"
}
},
"initial_payment_intent_id": "int_hkdmn5lcqh5enk76z9u_k6uxs0",
"next_triggered_by": "merchant",
"merchant_trigger_reason": "unscheduled",
"status": "VERIFIED",
"created_at": "2025-03-12T09:53:18+0000",
"updated_at": "2025-03-12T09:53:20+0000",
"client_secret": "eyJhbGciOiJIUzI1NiJ9.eyJhbGciOiJSUzI1NiIs...",
"mandate": {
"payment_amount_type": "VARIABLE"
},
"purpose": "recurring"
}
}
Cards
Default card details
This endpoint allows you to retrieve detailed information about the customer’s default card (payment consented).
GET
/
customer
/
default-card
/
{customer_id}
curl -X GET https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6 \
-u "YOUR_UUID:YOUR_SECRET" \
-H "X-API-Version: 1.2" \
-H "Content-Type: application/json"
const response = await fetch("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6", {
method: "GET",
headers: {
Authorization: "Basic " + Buffer.from("YOUR_UUID:YOUR_SECRET").toString("base64"),
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
"https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6",
auth=("YOUR_UUID", "YOUR_SECRET"),
headers={
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6")
request = Net::HTTP::Get.new(uri)
request.basic_auth("YOUR_UUID", "YOUR_SECRET")
request["X-API-Version"] = "1.2"
request["Content-Type"] = "application/json"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)
<?php
$ch = curl_init("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_USERPWD => "YOUR_UUID:YOUR_SECRET",
CURLOPT_HTTPHEADER => [
"X-API-Version: 1.2",
"Content-Type: application/json",
],
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Example {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString("YOUR_UUID:YOUR_SECRET".getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6"))
.header("Authorization", "Basic " + credentials)
.header("X-API-Version", "1.2")
.header("Content-Type", "application/json")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth("YOUR_UUID", "YOUR_SECRET")
req.Header.Set("X-API-Version", "1.2")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_UUID:YOUR_SECRET")));
request.Headers.Add("X-API-Version", "1.2");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"message": "Card found successfully",
"card_details": {
"id": "cst_hkdmt2bxdh5enk6uxs0",
"request_id": "5ff52ab4-1f6c-4dd3-9f43-4ee0a20f0f24",
"customer_id": "cus_hkdmn5lcqh5enc37sp6",
"payment_method": {
"type": "card",
"id": "mtd_hkdmn5lcqh5enk7388n",
"card": {
"expiry_month": "12",
"expiry_year": "2026",
"name": "",
"bin": "40120003",
"last4": "1003",
"brand": "visa",
"issuer_country_code": "RU",
"card_type": "CREDIT",
"fingerprint": "4yOwItYXF79ScJEtmG+qW42QuU0=",
"issuer_name": "VISA PRODUCTION SUPPORT CLIENT BID 1",
"is_commercial": false,
"number_type": "PAN"
}
},
"initial_payment_intent_id": "int_hkdmn5lcqh5enk76z9u_k6uxs0",
"next_triggered_by": "merchant",
"merchant_trigger_reason": "unscheduled",
"status": "VERIFIED",
"created_at": "2025-03-12T09:53:18+0000",
"updated_at": "2025-03-12T09:53:20+0000",
"client_secret": "eyJhbGciOiJIUzI1NiJ9.eyJhbGciOiJSUzI1NiIs...",
"mandate": {
"payment_amount_type": "VARIABLE"
},
"purpose": "recurring"
}
}
Headers
string
default:"1.2"
required
The API version to use. Supported versions are
1.1 and 1.2.Path Parameters
string
required
The unique identifier of the customer.
Response Body
The response is in JSON format and contains:| Field | Type | Description |
|---|---|---|
message | string | Status message of the operation (e.g. “Card found successfully”). |
card_detailsobject | object | Detailed information about the customer’s saved card consent. |
↳id | string | Consent record ID (e.g. “cst_hkdmt2bxdh5enk6uxs0”). |
↳request_id | string | Unique request identifier for the consent creation call. |
↳customer_id | string | Airwallex customer ID linked to this consent. |
↳payment_methodobject | object | The payment method associated with this consent. |
↳type | string | Payment method type (always “card”). |
↳id | string | Payment method identifier (e.g. “mtd_hkdmn5lcqh5enk7388n”). |
↳cardobject | object | Card details associated with the payment method. |
↳expiry_month | string | Card expiry month (e.g. “12”). |
↳expiry_year | string | Card expiry year (e.g. “2026”). |
↳name | string | Cardholder name as entered during registration (may be empty). |
↳bin | string | Bank Identification Number — first 6–8 digits of the card. |
↳last4 | string | Last 4 digits of the card number (e.g. “1003”). |
↳brand | string | Card network brand (e.g. “visa”, “mastercard”). |
↳issuer_country_code | string | ISO 3166-1 alpha-2 country code of the card-issuing bank (e.g. “RU”). |
↳card_type | string | Card product type (e.g. “CREDIT”, “DEBIT”). |
↳fingerprint | string | Unique fingerprint hash of the card used to detect duplicates. |
↳issuer_name | string | Full name of the card-issuing financial institution. |
↳is_commercial | boolean | Indicates whether the card is a commercial/corporate card. |
↳number_type | string | Type of card number used (e.g. “PAN”). |
↳initial_payment_intent_id | string | ID of the initial payment intent used to verify and save the card. |
↳next_triggered_by | string | Indicates who initiates the next charge — “merchant” or “customer”. |
↳merchant_trigger_reason | string | Reason for merchant-triggered subsequent charges (e.g. “unscheduled”, “recurring”). |
↳status | string | Consent status (e.g. “VERIFIED”, “PENDING”, “EXPIRED”). |
↳created_at | string | ISO 8601 timestamp when the consent record was created. |
↳updated_at | string | ISO 8601 timestamp when the consent record was last updated. |
↳client_secret | string | Signed JWT client secret used to perform client-side operations on this consent. |
↳mandateobject | object | Mandate settings for this card consent. |
↳payment_amount_type | string | Whether the charge amount is fixed or variable (e.g. “VARIABLE”, “FIXED”). |
↳purpose | string | Consent purpose (e.g. “recurring”). |
Response Codes
| Code | Description |
|---|---|
| 200 | If the request is successful, the detailed card information is returned. |
| 401 | Unauthorized. Missing or invalid credentials. |
| 404 | Not Found. Default card not found for the specified customerId. |
| 500 | Internal Server Error. |
curl -X GET https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6 \
-u "YOUR_UUID:YOUR_SECRET" \
-H "X-API-Version: 1.2" \
-H "Content-Type: application/json"
const response = await fetch("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6", {
method: "GET",
headers: {
Authorization: "Basic " + Buffer.from("YOUR_UUID:YOUR_SECRET").toString("base64"),
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
"https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6",
auth=("YOUR_UUID", "YOUR_SECRET"),
headers={
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6")
request = Net::HTTP::Get.new(uri)
request.basic_auth("YOUR_UUID", "YOUR_SECRET")
request["X-API-Version"] = "1.2"
request["Content-Type"] = "application/json"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)
<?php
$ch = curl_init("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_USERPWD => "YOUR_UUID:YOUR_SECRET",
CURLOPT_HTTPHEADER => [
"X-API-Version: 1.2",
"Content-Type: application/json",
],
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Example {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString("YOUR_UUID:YOUR_SECRET".getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6"))
.header("Authorization", "Basic " + credentials)
.header("X-API-Version", "1.2")
.header("Content-Type", "application/json")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth("YOUR_UUID", "YOUR_SECRET")
req.Header.Set("X-API-Version", "1.2")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://qa-payments.mygigsters.com.au/api/v1/customer/default-card/cus_hkdmn5lcqh5enc37sp6");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_UUID:YOUR_SECRET")));
request.Headers.Add("X-API-Version", "1.2");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"message": "Card found successfully",
"card_details": {
"id": "cst_hkdmt2bxdh5enk6uxs0",
"request_id": "5ff52ab4-1f6c-4dd3-9f43-4ee0a20f0f24",
"customer_id": "cus_hkdmn5lcqh5enc37sp6",
"payment_method": {
"type": "card",
"id": "mtd_hkdmn5lcqh5enk7388n",
"card": {
"expiry_month": "12",
"expiry_year": "2026",
"name": "",
"bin": "40120003",
"last4": "1003",
"brand": "visa",
"issuer_country_code": "RU",
"card_type": "CREDIT",
"fingerprint": "4yOwItYXF79ScJEtmG+qW42QuU0=",
"issuer_name": "VISA PRODUCTION SUPPORT CLIENT BID 1",
"is_commercial": false,
"number_type": "PAN"
}
},
"initial_payment_intent_id": "int_hkdmn5lcqh5enk76z9u_k6uxs0",
"next_triggered_by": "merchant",
"merchant_trigger_reason": "unscheduled",
"status": "VERIFIED",
"created_at": "2025-03-12T09:53:18+0000",
"updated_at": "2025-03-12T09:53:20+0000",
"client_secret": "eyJhbGciOiJIUzI1NiJ9.eyJhbGciOiJSUzI1NiIs...",
"mandate": {
"payment_amount_type": "VARIABLE"
},
"purpose": "recurring"
}
}
Last modified on November 10, 2026
Was this page helpful?
