POST
https://api.myidvirtual.com
/
transactions
Criar Transação
curl --request POST \
  --url https://api.myidvirtual.com/transactions \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "coin_amount": 123,
  "type": "<string>",
  "revId": "<string>",
  "promo_id": "<string>"
}
'
{
  "id": "transaction_123",
  "coin_amount": 20,
  "type": "SIGNATURE",
  "payment_type": "bitpix",
  "is_cripto": true,
  "status": "PENDING",
  "revId": "70373",
  "promo_id": "",
  "payment_url": "https://payment.bitpix.com/...",
  "qr_code": "data:image/png;base64,...",
  "pix_code": "00020126580014br.gov.bcb.pix...",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "expires_at": "2024-01-15T11:30:00.000Z"
}

​
Criar Transação

Endpoint para criar transações de pagamento. Suporta múltiplos métodos de pagamento e tipos de transação.

​
Autenticação

​
Authorization
string
required
Bearer token JWT do usuário autenticado

​
Query Parameters

​
payment_type
string
required
Tipo de pagamento a ser processado
  • bitpix - Pagamento com criptomoeda via Bitpix (com ou sem cripto)
  • mercadoPago - Pagamento via Mercado Pago
​
is_cripto
boolean
Define se o pagamento Bitpix será processado como criptomoeda. Usar apenas quando payment_type=bitpix
  • true - Pagamento em criptomoeda
  • Omitido ou false - Pagamento via PIX tradicional

​
Request Body

​
coin_amount
number
required
Valor da transação (em moeda/créditos)
​
type
string
required
Tipo da transação
  • COIN - Compra de créditos/moedas
  • SIGNATURE - Assinatura de plano
​
revId
string
required
ID do revendedor (reseller ID)
​
promo_id
string
ID do cupom promocional (deixar vazio "" se não houver)

​
Exemplos de Requisição

​
Pagamento Cripto (Bitpix)

cURL
curl -X POST 'https://api.myidvirtual.com/transactions?payment_type=bitpix&is_cripto=true' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{
    "coin_amount": 20,
    "type": "SIGNATURE",
    "revId": "70373",
    "promo_id": ""
  }'

​
Pagamento PIX via Bitpix

cURL
curl -X POST 'https://api.myidvirtual.com/transactions?payment_type=bitpix' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{
    "coin_amount": 20,
    "type": "COIN",
    "revId": "70373",
    "promo_id": ""
  }'

​
Pagamento via Mercado Pago

cURL
curl -X POST 'https://api.myidvirtual.com/transactions?payment_type=mercadoPago' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{
    "coin_amount": 20,
    "type": "SIGNATURE",
    "revId": "70373",
    "promo_id": "PROMO2024"
  }'

​
Responses

{
  "id": "transaction_123",
  "coin_amount": 20,
  "type": "SIGNATURE",
  "payment_type": "bitpix",
  "is_cripto": true,
  "status": "PENDING",
  "revId": "70373",
  "promo_id": "",
  "payment_url": "https://payment.bitpix.com/...",
  "qr_code": "data:image/png;base64,...",
  "pix_code": "00020126580014br.gov.bcb.pix...",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "expires_at": "2024-01-15T11:30:00.000Z"
}

​
Tipos de Pagamento

​
Bitpix com Criptomoeda

  • Query: ?payment_type=bitpix&is_cripto=true
  • Descrição: Pagamento com criptomoedas (Bitcoin, USDT, etc)
  • Tempo: Variável (15min - 1h)
  • Recursos: QR Code, endereço de carteira

​
Bitpix com PIX

  • Query: ?payment_type=bitpix
  • Descrição: Pagamento via PIX tradicional processado pelo Bitpix
  • Tempo: Instantâneo
  • Recursos: QR Code PIX, código copiável

​
Mercado Pago

  • Query: ?payment_type=mercadoPago
  • Descrição: Pagamento via Mercado Pago
  • Tempo: Imediato
  • Recursos: Link de pagamento, múltiplos métodos

​
Tipos de Transação

​
COIN (Compra de Créditos)

Usado para comprar créditos/moedas na plataforma 
{
  "type": "COIN",
  "coin_amount": 20
}

​
SIGNATURE (Assinatura)

Usado para assinar ou renovar planos 
{
  "type": "SIGNATURE",
  "coin_amount": 1
}

​
Cupons Promocionais

Para aplicar um cupom, informe o promo_id: 
{
  "coin_amount": 20,
  "type": "SIGNATURE",
  "revId": "70373",
  "promo_id": "PROMO2024"
}
Se não houver cupom, envie string vazia: 
{
  "promo_id": ""
}

​
Fluxo de Pagamento

  1. Criar transação - POST /transactions com parâmetros corretos
  2. Receber dados de pagamento - QR Code, link ou código PIX
  3. Usuário efetua pagamento - Via app bancário, wallet cripto ou Mercado Pago
  4. Webhook notifica - Sistema recebe confirmação automática
  5. Créditos liberados - Conta do usuário é atualizada
O parâmetro is_cripto=true só deve ser usado quando payment_type=bitpix. Não use com Mercado Pago.
Para pagamentos em criptomoeda, o tempo de confirmação pode variar conforme a rede blockchain. Bitcoin pode levar até 1 hora.