Início rápido

Este guia percorre o caminho completo: obter um token de acesso, modelar o que você vende, abrir um checkout e receber um pagamento Pix na página hospedada.

Todas as chamadas vão para https://api.moneydev.com.br. Antes, defina MONEYDEV_CLIENT_ID e MONEYDEV_CLIENT_SECRET a partir do cliente de API criado no Dashboard.

Obtenha um token de acesso

curl --request POST https://api.moneydev.com.br/oauth/token \
  --user "$MONEYDEV_CLIENT_ID:$MONEYDEV_CLIENT_SECRET" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data grant_type=client_credentials

Copie o access_token da resposta para ACCESS_TOKEN. Ele dura 15 minutos. Veja Autenticação para detalhes.

Crie um produto e sua oferta

Um produto é o que você vende; uma oferta é um preço dele. Crie os dois de uma vez. Valores são em centavos — 49900 é R$ 499,00.

curl --request POST https://api.moneydev.com.br/v1/products \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Plano Pro",
    "default_offer": { "name": "Anual", "amount_minor": 49900, "currency": "BRL" }
  }'

A resposta inclui default_offer.id (um offer_…). Guarde-o para o próximo passo.

(Opcional) Crie um cliente

Vincule um cliente para não reenviar os dados do comprador depois.

curl --request POST https://api.moneydev.com.br/v1/customers \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{ "name": "João da Silva", "email": "joao.silva@example.com" }'

Abra um checkout

curl --request POST https://api.moneydev.com.br/v1/checkouts \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "offer_id": "offer_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "external_id": "order_1042",
    "success_url": "https://loja.example.com/pedido/1042/ok"
  }'

A resposta traz uma checkout_url em pay.moneydev.com.br e status: "open".

Envie o comprador para pagar

Redirecione o comprador para a checkout_url. Ele paga com Pix na página hospedada e volta para a sua success_url.

Confirme o pagamento

Consulte o checkout até o status ser completed:

curl https://api.moneydev.com.br/v1/checkouts/checkout_7f8a9b0c-1d2e-4f3a-8b4c-5d6e7f8a9b0c \
  --header "Authorization: Bearer $ACCESS_TOKEN"

`status`	Significado
`open`	Aguardando pagamento
`completed`	Pago — libere o pedido
`expired`	Passaram 24 h sem pagamento
`canceled`	Cancelado antes do pagamento

Para não consultar em loop, assine o webhook payment.succeeded. Como ele não repete em caso de falha, mantenha esta consulta como reconciliação.

Introdução

Conta

Clientes

Produtos

Ofertas

Checkouts

Próximos passos

Checkouts

Autenticação

​Próximos passos

Checkouts

Autenticação

Próximos passos