Status: Operacional

Documentação API v3

Visão Geral

A API da Dcx permite que você integre nosso gateway de pagamentos de alto desempenho em qualquer sistema de terceiros. Nossa infraestrutura v3 foi desenhada para ser robusta, segura e extremamente veloz.

Endpoints Seguros

Toda comunicação é criptografada via TLS.

Tempo Real

Consulte e receba status instantaneamente.

Multimeios

PIX, Cartão e Boleto em uma única API.

Autenticação

Utilize suas credenciais geradas no painel administrativo para autenticar cada requisição.

POST Dcx Autenticação
Envie os parâmetros public_key e private_key em cada chamada POST ou passe como headers (X-Public-Key e X-Private-Key). Opcionalmente, pode ser usado o modelo legado (client_id / client_secret).

Gerar PIX QR Code (In)

Gere cobranças dinâmicas com QR Code e chave copia-e-cola.

POST /v3/pix/qrcode.php

Request (PHP cURL)

$ch = curl_init('https://app.atechpay.fun/v3/pix/qrcode.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'public_key' => 'SUA_CHAVE_PUBLICA',
    'private_key' => 'SUA_CHAVE_SECRETA',
    'nome' => 'Nome do Cliente',
    'cpf' => '000.000.000-00',
    'valor' => 100.00,
    'descricao' => 'Depósito PIX',
    'urlnoty' => 'https://seu-sistema.com/webhook'
]);
$res = curl_exec($ch);
curl_close($ch);

Response (JSON)

{
    "statusCode": 200,
    "status": "success",
    "qrcode": "00020101021226870014br.gov.bcb.pix...",
    "external_id": "e4f8b92c10a3d4e...",
    "amount": 100.00
}

Transferência PIX (Out)

Envie pagamentos PIX instantaneamente para qualquer chave cadastrada.

POST /v3/pix/payment.php

Request (PHP cURL)

$ch = curl_init('https://app.atechpay.fun/v3/pix/payment.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'public_key' => 'SUA_CHAVE_PUBLICA',
    'private_key' => 'SUA_CHAVE_SECRETA',
    'nome' => 'Nome do Favorecido',
    'cpf' => '000.000.000-00',
    'chave_pix' => '00000000000',
    'valor' => 50.00,
    'descricao' => 'Pagamento Fornecedor',
    'urlnoty' => 'https://seu-sistema.com/webhook'
]);
$res = curl_exec($ch);
curl_close($ch);

Response (JSON)

{
    "statusCode": 200,
    "status": "success",
    "external_id": "e4f8b92c10a3d4e...",
    "amount": 50.00
}

Cartão Global

Processamento direto de cartões de crédito nacionais e internacionais.

POST /v3/card/pay.php

Request (PHP cURL)

$ch = curl_init('https://app.atechpay.fun/v3/card/pay.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'public_key' => 'SUA_CHAVE_PUBLICA',
    'private_key' => 'SUA_CHAVE_SECRETA',
    'amount' => 150.00,
    'holder_name' => 'JOAO DA SILVA',
    'card_number' => '4444555566667777',
    'expiry' => '12/28',
    'cvv' => '123',
    'installments' => 1,
    'customer' => json_encode([
        'name' => 'Cliente Exemplo',
        'email' => 'cliente@email.com',
        'cpf' => '00000000000'
    ])
]);
$res = curl_exec($ch);
curl_close($ch);

Response (JSON)

{
    "statusCode": 200,
    "status": "success",
    "transaction_id": "c7a8b92c10a3d4e...",
    "amount": 150.00
}

Boleto Bancário

Geração de boletos registrados para pagamento em qualquer banco.

POST /v3/boleto/generate.php

Request (PHP cURL)

$ch = curl_init('https://app.atechpay.fun/v3/boleto/generate.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'public_key' => 'SUA_CHAVE_PUBLICA',
    'private_key' => 'SUA_CHAVE_SECRETA',
    'amount' => 89.90,
    'payer_name' => 'Maria Oliveira',
    'payer_cpf' => '000.000.000-00',
    'postback_url' => 'https://seu-sistema.com/notify'
]);
$res = curl_exec($ch);
echo $res;

Response (JSON)

{
    "statusCode": 200,
    "status": "success",
    "boleto_url": "https://api.banco.com/boleto/...",
    "barcode": "34191.09008 00000.000000 00000.000000 1 00000000000000",
    "external_id": "b9f8b92c10a3d4e...",
    "amount": 89.90
}

Criptomoedas

Geração de endereços para recebimento de pagamentos em Crypto.

POST /v3/crypto/generate
$ch = curl_init('https://app.atechpay.fun/v3/crypto/generate');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'public_key' => 'SUA_PUBLIC_KEY',
    'private_key' => 'SUA_PRIVATE_KEY',
    'amount' => 100.00,
    'currency' => 'USDT_TRC20',
    'payer_name' => 'João Cripto',
    'postback_url' => 'https://seu-sistema.com/webhook'
]);
$res = curl_exec($ch);
echo $res;

Webhooks (Notificações)

A Dcx enviará um POST para sua URL de notificação sempre que o status de uma transação mudar.

Estrutura Sugerida

{
  "event": "payment.paid",
  "transaction_id": "CHK_65F2A...",
  "external_id": "...",
  "amount": 100.00,
  "status": "PAID",
  "payment_method": "PIX"
}