Skip to main content
POST
/
stripe
/
onboarding-link
curl -X POST 'https://api.goatpay.com.br/v1/stripe/onboarding-link' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json'
{
  "success": true,
  "message": "Link de onboarding Stripe",
  "data": {
    "url": "https://connect.stripe.com/setup/e/acct_xxx/yyy",
    "expiresAt": 1717353600
  },
  "requestId": "req_abc"
}
curl -X POST 'https://api.goatpay.com.br/v1/stripe/onboarding-link' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json'
{
  "success": true,
  "message": "Link de onboarding Stripe",
  "data": {
    "url": "https://connect.stripe.com/setup/e/acct_xxx/yyy",
    "expiresAt": 1717353600
  },
  "requestId": "req_abc"
}

Resposta

CampoDescrição
urlAbra no navegador (ou redirecione o merchant) para o formulário Stripe
expiresAtUnix timestamp de expiração do link (links são de uso único)
Cada chamada gera um link novo. Se o merchant voltar com ?stripe=refresh no dashboard, gere outro link — não reutilize URLs expiradas.

Depois do cadastro

Aguarde charges_enabled e payouts_enabled na Stripe. Só então use checkout cartão ou links com CARD. Permissão: stripe/onboarding. Guia: Cartão Stripe Connect.

Authorizations

X-API-Key
string
header
required

Chave gp_live_... criada em Integrações → Chaves de API no dashboard.

Response

Link de onboarding Stripe gerado.

success
boolean
required
message
string
required
data
object
required
requestId
string