Conectar LivePix
Confere o Client ID e o Client Secret na LivePix, guarda cifrado e cadastra o endereço de avisos da Onny. Papéis: owner, admin.
PUT
/payments/v1/orgs/{orgId}/integrations/livepix Exige Authorization: Bearer com o token de login.
Parâmetros de caminho
orgIduuidobrigatório
Corpo da requisição
acceptTermsbooleanAceite dos Termos do Onny Pay (obrigatório).
clientIdstringobrigatórioClient ID da aplicação criada na LivePix (Configurações → API).
máx. 200clientSecretstringobrigatórioClient Secret da mesma aplicação.
máx. 300
Respostas
200OK
{
"id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f",
"provider": "mercadopago",
"accountLabel": "texto",
"tokenHint": "texto",
"mode": "live",
"status": "pending",
"signedWebhooks": true,
"lastVerifiedAt": "2026-10-11T12:00:00+00:00",
"createdAt": "2026-10-11T12:00:00+00:00"
}9 campos descrição de cada um
iduuidId.
providerstringProvedor (mercadopago).
accountLabelstringConta conectada (apelido ou e-mail).
tokenHintstringToken mascarado.
modestringlive ou test.
statusstringactive ou invalid (o token parou de funcionar).
signedWebhooksbooleanSe o segredo de webhook foi informado (avisos assinados).
lastVerifiedAtdatetime | nullÚltima verificação do token.
createdAtdatetimeConectada em.
400Bad Request
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "auth.invalid / validation",
"status": 400,
"detail": "Mensagem legível para pessoas.",
"code": "auth.invalid / validation",
"traceId": "00-4bf9…-01"
}401Unauthorized
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "Unauthorized",
"status": 401,
"detail": "Mensagem legível para pessoas.",
"code": "Unauthorized",
"traceId": "00-4bf9…-01"
}403Forbidden
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 403,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}404Not Found
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 404,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}