Criar transação (voucher ou recarga)

Cria a compra e debita a conta. Assíncrono: response devolve
status inicial (PROCESSING); lifecycle final chega via webhook
(global_marketplace_recharge ou global_marketplace_voucher).

Lifecycle sucesso: PROCESSING → REQUESTED_PAYMENT →
AWAITING_CONFIRMATION → PURCHASED (UX terminal — voucher/recarga
liberados pro user) → REQUESTED_CONFIRMATION → APPROVED (ledger).

Lifecycle erro pré-débito: PROCESSING → DENIED (sem ajuste financeiro).

Lifecycle erro pós-débito: ... → AWAITING_CONFIRMATION → REVERSE →
REQUESTED_REVERSE → ROLLBACK (estorno automático na conta).

RECHARGE

  • merchandiseType=RECHARGE + phoneAreaCode (DDD) + phoneNumber.
  • Valide o DDD contra allowed_area_codes do merchandise (evita MKTA-001).
  • amount deve bater com price.fixed_value.

VOUCHER

  • merchandiseType=VOUCHER (sem dados de telefone).
  • PIN/serial/recibo vêm no webhook quando status=PURCHASED, em
    purchaseMetadata.pin / .serial / .receipt.

PIN

Header X-Account-Pin obrigatório (não no body — header é redacted em logs).

Idempotência (2 camadas)

  1. idempotencyKey (body) ou Idempotency-Key (header) → vira o
    customer_external_id enviado à Autra. Reenvio devolve o registro
    existente (Autra também valida — MKTA-013).
  2. Anti-duplo-débito RECHARGE: mesma conta + mesmo telefone nos
    últimos 30s → devolve o registro existente (espelha MKTA-012 da Autra).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
Body Params
uuid
required
string
enum
required
Allowed:
float
required
string

DDD (RECHARGE only).

string

Número do celular (RECHARGE only).

uuid
Headers
string
required
string
Responses

400

MERCHANDISE_REQUIRED INVALID_TYPE INVALID_AMOUNT PHONE_REQUIRED INVALID_PHONE

422

AMOUNT_MISMATCH (MKTA-003) ou DUPLICATE_TRANSACTION (MKTA-012).

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json