Pular para o conteúdo
PlanosDocsPayments
Infraestrutura com personalidade.
DocsPaymentsStatusMarcaTermosPrivacidadeContato
© 2026 onny
ComeçandoVisão geralPrimeira chamadaAutenticaçãoErrosLimites e paginação
Conta e loginPOSTCriar contaPOSTEntrar com e-mail e senhaPOSTRenovar sessãoPOSTEncerrar sessãoGETVer minha conta
OrganizaçõesGETListar minhas organizaçõesPOSTCriar organizaçãoGETVer organizaçãoPUTRenomear organizaçãoDELExcluir organização
Membros e convitesGETListar membrosPUTMudar papel de um membroDELRemover membro ou sair da organizaçãoPOSTConvidar membroGETListar convites pendentesDELRevogar convitePOSTVer convite pelo linkPOSTAceitar convite
ProjetosGETListar projetosPOSTCriar projetoGETVer projetoPUTAtualizar projetoDELRemover projeto
Chaves e usoGETTestar chave de APIGETListar chaves do projetoPOSTCriar chave de APIDELRevogar chave de APIGETVer uso do mês
PlanosGETListar planos
Pagamentos (Onny Pay)POSTCriar cobrança PixGETVer cobrançaGETListar cobranças do projetoGETPágina de pagamento (pública)GETVer integração Mercado PagoPUTConectar Mercado PagoPOSTTestar conexãoDELDesconectar Mercado PagoGETListar cobranças da organização
Administração da plataformaGETListar organizaçõesPOSTAtivar ou renovar planoPOSTCancelar plano
OutrasPOSTRecuperar conta com códigoDELExcluir minha contaPOSTComeçar a conectar o DiscordGETVer códigos de recuperaçãoPOSTGerar códigos de recuperaçãoGETListar minhas sessõesDELEncerrar uma sessãoPOSTSair dos outros aparelhosGETVer uso por diaPOSTSair de todas as organizaçõesGETVer histórico de atividadesGETListar webhooksPOSTCadastrar webhookPUTEditar webhookDELRemover webhookGETListar entregas recentesPOSTReenviar entregaGETVer segredo de assinaturaPOSTEnviar evento de testeGETListar tipos de evento
Pagamentos (Onny Pay)

Conectar Mercado Pago

Valida o token no Mercado Pago (conta do Brasil) e guarda cifrado. Substitui o token anterior. Papéis: owner, admin.

PUT/payments/v1/orgs/{orgId}/integrations/mercadopago

Exige Authorization: Bearer com o token de login.

curl -X PUT "https://api.onny.space/payments/v1/orgs/<orgId>/integrations/mercadopago" \
  -H "Authorization: Bearer $ONNY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"acceptTerms":true,"accessToken":"eyJhbGciOiJSUzI1NiIs…","webhookSecret":"texto"}'
PUTapi.onny.space/payments/v1/orgs/%7BorgId%7D/integrations/mercadopago

Envie a requisição para ver status, tempo e corpo da resposta.

Parâmetros de caminho

  • orgIduuidobrigatório

Corpo da requisição application/json

  • acceptTermsboolean

    Aceite dos Termos do Onny Pay (obrigatório): a onny só integra a loja ao Mercado Pago e não participa da venda nem do pagamento.

  • accessTokenstringobrigatório

    Access Token do Mercado Pago da organização (APP_USR-… em produção, TEST-… em teste).

    máx. 300
  • webhookSecretstring | null

    Segredo de assinatura dos webhooks do app no Mercado Pago (opcional, recomendado).

    máx. 200

Respostas

200OK
{
  "id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f",
  "provider": "texto",
  "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
  • iduuid

    Id.

  • providerstring

    Provedor (mercadopago).

  • accountLabelstring

    Conta conectada (apelido ou e-mail).

  • tokenHintstring

    Token mascarado.

  • modestring

    live ou test.

  • statusstring

    active ou invalid (o token parou de funcionar).

  • signedWebhooksboolean

    Se o segredo de webhook foi informado (avisos assinados).

  • lastVerifiedAtdatetime | null

    Última verificação do token.

  • createdAtdatetime

    Conectada 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"
}
AnteriorVer integração Mercado PagoPróximaDesconectar Mercado Pago