GET /v1/apple-pay/domains HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
curl "https://api-global.fastpaybrasil.com/v1/apple-pay/domains" \
-u "$FINVIA_API_KEY:"
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
const response = await fetch('https://api-global.fastpaybrasil.com/v1/apple-pay/domains', {
headers: { Authorization: `Basic ${credentials}` },
});
const { data } = await response.json();
const checkout = data.find((d) => d.domain === 'checkout.minhaloja.com.br');
console.log(checkout?.status ?? 'não registrado');
import os
import requests
response = requests.request(
"GET",
"https://api-global.fastpaybrasil.com/v1/apple-pay/domains",
auth=(os.environ["FINVIA_API_KEY"], ""),
timeout=30,
)
print(response.status_code)
if response.content:
print(response.json())
<?php
$ch = curl_init('https://api-global.fastpaybrasil.com/v1/apple-pay/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, PHP_EOL;
print_r(json_decode($body, 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 Exemplo {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api-global.fastpaybrasil.com/v1/apple-pay/domains"))
.header("Authorization", "Basic " + credentials)
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http.Headers;
using System.Text;
var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);
var request = new HttpRequestMessage(HttpMethod.Get, "https://api-global.fastpaybrasil.com/v1/apple-pay/domains");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api-global.fastpaybrasil.com/v1/apple-pay/domains", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api-global.fastpaybrasil.com/v1/apple-pay/domains")
request = Net::HTTP::Get.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts response.body
{
"data": [
{
"id": "2xYq8Lm3NcR7tVb1KdZ4wP6sQhE",
"domain": "checkout.minhaloja.com.br",
"status": "verified",
"verifiedAt": "2026-10-27T18:05:00.000Z",
"lastVerificationError": null,
"verificationFile": {
"path": "https://checkout.minhaloja.com.br/.well-known/apple-developer-merchantid-domain-association",
"content": "7B227073706964223A22..."
},
"createdAt": "2026-10-27T18:00:00.000Z",
"updatedAt": "2026-10-27T18:05:00.000Z"
}
]
}
{
"statusCode": 403,
"message": "Acesso negado",
"error": "Forbidden"
}
Apple Pay
Listar domínios Apple Pay
Lista todos os domínios Apple Pay registrados na sua conta, com o status de verificação de cada um.
GET
/
v1
/
apple-pay
/
domains
GET /v1/apple-pay/domains HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
curl "https://api-global.fastpaybrasil.com/v1/apple-pay/domains" \
-u "$FINVIA_API_KEY:"
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
const response = await fetch('https://api-global.fastpaybrasil.com/v1/apple-pay/domains', {
headers: { Authorization: `Basic ${credentials}` },
});
const { data } = await response.json();
const checkout = data.find((d) => d.domain === 'checkout.minhaloja.com.br');
console.log(checkout?.status ?? 'não registrado');
import os
import requests
response = requests.request(
"GET",
"https://api-global.fastpaybrasil.com/v1/apple-pay/domains",
auth=(os.environ["FINVIA_API_KEY"], ""),
timeout=30,
)
print(response.status_code)
if response.content:
print(response.json())
<?php
$ch = curl_init('https://api-global.fastpaybrasil.com/v1/apple-pay/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, PHP_EOL;
print_r(json_decode($body, 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 Exemplo {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api-global.fastpaybrasil.com/v1/apple-pay/domains"))
.header("Authorization", "Basic " + credentials)
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http.Headers;
using System.Text;
var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);
var request = new HttpRequestMessage(HttpMethod.Get, "https://api-global.fastpaybrasil.com/v1/apple-pay/domains");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api-global.fastpaybrasil.com/v1/apple-pay/domains", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api-global.fastpaybrasil.com/v1/apple-pay/domains")
request = Net::HTTP::Get.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts response.body
{
"data": [
{
"id": "2xYq8Lm3NcR7tVb1KdZ4wP6sQhE",
"domain": "checkout.minhaloja.com.br",
"status": "verified",
"verifiedAt": "2026-10-27T18:05:00.000Z",
"lastVerificationError": null,
"verificationFile": {
"path": "https://checkout.minhaloja.com.br/.well-known/apple-developer-merchantid-domain-association",
"content": "7B227073706964223A22..."
},
"createdAt": "2026-10-27T18:00:00.000Z",
"updatedAt": "2026-10-27T18:05:00.000Z"
}
]
}
{
"statusCode": 403,
"message": "Acesso negado",
"error": "Forbidden"
}
Esta rota mostra os domínios Apple Pay da sua conta e em que situação cada um está. Use para conferir se o hostname do checkout está
O significado de cada campo está em Registrar domínio.
verified antes de publicar o botão e para montar uma tela de configuração no seu sistema.
Quando usar
| Situação | O que fazer |
|---|---|
| Conferir se o checkout está pronto | Procure o hostname exato da página e confira status: "verified" |
Investigar APPLE_PAY_DOMAIN_NOT_VERIFIED na validação de sessão | Veja se o hostname enviado pelo navegador está na lista e verificado |
Recuperar o id de um domínio | Localize pelo campo domain |
Antes de chamar
- Use a chave secreta (
sk_) no seu backend. - O usuário dono da chave precisa da permissão de domínios Apple Pay (perfis Owner, Manager e Desenvolvedor).
Respostas
Domínios registrados na conta.
Show propriedades do domínio
Show propriedades do domínio
| HTTP | Significado | Corpo |
|---|---|---|
200 | Lista obtida | { "data": [...] } |
401 | Credencial inválida | { "statusCode": 401, "message": "Unauthorized" } |
403 | Usuário dono da chave sem permissão de domínios Apple Pay | { "statusCode": 403, "message": "Acesso negado", "error": "Forbidden" } |
Erros comuns
| Sintoma | Causa | Como resolver |
|---|---|---|
| Lista vazia | Nenhum domínio registrado nesta conta | Registre com POST /v1/apple-pay/domains |
O hostname aparece, mas pending | O domínio ainda não foi validado | Hospede o arquivo e chame a validação |
www.minhaloja.com.br não aparece, mas minhaloja.com.br sim | Cada hostname é um registro separado | Registre também o hostname com www |
GET /v1/apple-pay/domains HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
curl "https://api-global.fastpaybrasil.com/v1/apple-pay/domains" \
-u "$FINVIA_API_KEY:"
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');
const response = await fetch('https://api-global.fastpaybrasil.com/v1/apple-pay/domains', {
headers: { Authorization: `Basic ${credentials}` },
});
const { data } = await response.json();
const checkout = data.find((d) => d.domain === 'checkout.minhaloja.com.br');
console.log(checkout?.status ?? 'não registrado');
import os
import requests
response = requests.request(
"GET",
"https://api-global.fastpaybrasil.com/v1/apple-pay/domains",
auth=(os.environ["FINVIA_API_KEY"], ""),
timeout=30,
)
print(response.status_code)
if response.content:
print(response.json())
<?php
$ch = curl_init('https://api-global.fastpaybrasil.com/v1/apple-pay/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, PHP_EOL;
print_r(json_decode($body, 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 Exemplo {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api-global.fastpaybrasil.com/v1/apple-pay/domains"))
.header("Authorization", "Basic " + credentials)
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http.Headers;
using System.Text;
var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);
var request = new HttpRequestMessage(HttpMethod.Get, "https://api-global.fastpaybrasil.com/v1/apple-pay/domains");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://api-global.fastpaybrasil.com/v1/apple-pay/domains", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api-global.fastpaybrasil.com/v1/apple-pay/domains")
request = Net::HTTP::Get.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.code
puts response.body
{
"data": [
{
"id": "2xYq8Lm3NcR7tVb1KdZ4wP6sQhE",
"domain": "checkout.minhaloja.com.br",
"status": "verified",
"verifiedAt": "2026-10-27T18:05:00.000Z",
"lastVerificationError": null,
"verificationFile": {
"path": "https://checkout.minhaloja.com.br/.well-known/apple-developer-merchantid-domain-association",
"content": "7B227073706964223A22..."
},
"createdAt": "2026-10-27T18:00:00.000Z",
"updatedAt": "2026-10-27T18:05:00.000Z"
}
]
}
{
"statusCode": 403,
"message": "Acesso negado",
"error": "Forbidden"
}
Veja também
Consultar domínio
Um domínio pelo
id.Guia de Apple Pay
Fluxo completo, do domínio à cobrança.

