cURL
curl -X GET \
"https://{globale_web_domain}/Payments/Subscriptions/00000000-0000-0000-0000-000000000001?ids=sub-123&ids=sub-456"import requests
url = "https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"Results": [
{
"SubscriptionId": "sub-123",
"Data": {
"SubscriptionId": "sub-123",
"CultureCode": "en-US",
"BillingAddress": null,
"CardNumSuffix": "1234",
"ExpMonth": 12,
"ExpYear": 2025,
"Vendor": "VISA"
},
"Error": null
}
]
}Get subscription and payment reference details (Merchant to Global-e)
The merchant calls Global-e to return the current masked payment method and billing address per subscription ID, for display in the merchant portal. The response is a batch: one result per requested ID, each either with Data or with an Error.
GET
/
Payments
/
Subscriptions
/
{merchantGuid}
cURL
curl -X GET \
"https://{globale_web_domain}/Payments/Subscriptions/00000000-0000-0000-0000-000000000001?ids=sub-123&ids=sub-456"import requests
url = "https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{globale_web_domain}/Payments/Subscriptions/{merchantGuid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"Results": [
{
"SubscriptionId": "sub-123",
"Data": {
"SubscriptionId": "sub-123",
"CultureCode": "en-US",
"BillingAddress": null,
"CardNumSuffix": "1234",
"ExpMonth": 12,
"ExpYear": 2025,
"Vendor": "VISA"
},
"Error": null
}
]
}Server-to-server only. The call to Global-e Web must be made server-to-server and never from the client side. The
merchantGuid route parameter is a secret key that identifies the merchant and must not be exposed in browser-side code, client requests, or anywhere it could be intercepted. Keep it on the backend and issue this request from your server.Part of the Subscription Connector integration guide — see it for when and how to use this endpoint.
Path Parameters
Merchant GUID. Must be a valid GUID format. This is a secret API key that identifies the merchant. Server-to-server only — it must not be exposed in browser-side/client code, and this call must be made from your server.
Example:
"00000000-0000-0000-0000-000000000001"
Query Parameters
One or more subscription IDs. Typically sent as repeated query params: ids=id1&ids=id2.
Minimum array length:
1Response
Batch response: one result per requested subscription ID, in the same order as requested.
Array of one item per requested subscription ID, in the same order as requested.
Show child attributes
Show child attributes