Documentação API PradaPay

PRODUÇÃO: https://api.pradapay.com

Autenticação

HEADER

Todas as requisições devem incluir sua API Key no header:

{
    "api-key": "sua_chave_aqui"
}

Pagamento via Pix

POST https://api.pradapay.com/v1/gateway/

Cria uma nova transação Pix

Parâmetros

Parâmetro Tipo Descrição
requestNumber String ID único da transação
amount Decimal Valor da transação
client Object Dados do cliente

Request

{
    "id_produto": [222], //Opcional array
    "requestNumber": "12356",
    "amount": 1.50,
    "frete_valor": 0,   //Opcional
    "frete_nome": "",   //Opcional
    "quantidade": [1],  //Opcional array
    "api-key": "SUA_CHAVE",
    "postback": "https://seusite.com/callback", // Opcional
    "client": {
        "name": "João Silva",
        "document": "999.999.999-99",
        "email": "[email protected]",
        "userPhone": "(99) 99999-9999",
        "cep": "99999999",  //Opcional
        "estado": "SP", //Opcional
        "cidade": "São Paulo",  //Opcional
        "bairro": "Centro", //Opcional
        "rua": "Rua josé fernandes",  //Opcional
        "numeroEnd": "123", //Opcional
        "complemento": "AP 01"  //Opcional
    }
}

Response

{
    "status": "success",
    "paymentCode": "000201010212267...",
    "idTransaction": "52fc5262-4063-4900...",
    "paymentCodeBase64": "iVBORw0KGgoAAAANSUhEUg..."
}

Pagamento via Cartão

POST https://api.pradapay.com/v1/gateway/

Processa pagamento com cartão de crédito

Request

{
    "id_produto": [222], //Opcional array
    "requestNumber": "12356",
    "amount": 1.50,
    "frete_valor": 0,   //Opcional
    "frete_nome": "",   //Opcional
    "quantidade": [1],  //Opcional array
    "forma_pagamento": "cartao",
    "parcela": 1,
    "api-key": "SUA_CHAVE",
    "postback": "https://seusite.com/callback", // Opcional
    "client": {
        "name": "João Silva",
        "document": "999.999.999-99",
        "email": "[email protected]",
        "userPhone": "(99) 99999-9999",
        "cep": "99999999",  //Opcional
        "estado": "SP", //Opcional
        "cidade": "São Paulo",  //Opcional
        "bairro": "Centro", //Opcional
        "rua": "Rua josé fernandes",  //Opcional
        "numeroEnd": "123", //Opcional
        "complemento": "AP 01"  //Opcional
    },
    "card": {
        "nome": "João Silva",
        "numero": "4111111111111111",
        "mes": "12",
        "ano": "26",
        "cvv": "123"
    }
}

Response

{
    "idTransaction": "ORDE_1A0406EF...",
    "status": "success",
    "retorno_cartao": "PAID"
}

Pagamento via Boleto

POST https://api.pradapay.com/v1/gateway/

Processa pagamento via boleto bancário

Request

{
    "id_produto": [222], //Opcional array
    "requestNumber": "12356",
    "amount": 1,
    "quantidade": [1], //Opcional array
    "frete_valor": 0, //Opcional
    "frete_nome": "", //Opcional
    "utm_content": "",
    "utm_medium": "",
    "utm_campaign": "",
    "utm_source": "",
    "utm_term": "",
    "forma_pagamento": "boleto",
    "api-key": "SUA_CHAVE",
    "postback": "https://seusite.com/callback", // Opcional
    "client": {
        "name": "joao silva",
        "document": "046.213.680-95",
        "email": "[email protected]",
        "userPhone": "(12) 31231-2313",
        "cep": "99999999",
        "estado": "SP",
        "cidade": "São Paulo",
        "bairro": "Centro",
        "rua": "Rua josé fernandes",
        "numeroEnd": "123",
        "complemento": "AP 01"
    }
}

Response

{
    "idTransaction": "CHAR_4CAA3F04-6C6E-4E00-BAFB-8377DDEDBDD3",
    "message": "ok",
    "status": "success",
    "barcode": "03399853012970000024227020901016278150000015630",
    "pdf_url": "https://example.com/fc6c8e8e-884a-439f-acfc-7fe42a631172.pdf"
}

Webhooks

POST https://api.pradapay.com/v1/webhook/

Endpoint para verificação de status de pagamento

Request

{
    "idtransaction": "81bb141a-1746-49a8..."
}

Response

{
    "status": "PAID_OUT"
}

Cashout

POST https://api.pradapay.com/c1/cashout/

Solicitação de saque

Request

{
    "api-key": "SUA_CHAVE",
    "name": "Adm",
    "cpf": "70291669232",
    "keypix": "7029132323",
    "amount": 410.95
}

FAQs

Como receber notificações de pagamento?

Configure o URL do callback no momento da requisição.

Onde encontrar a API Key?

A chave está disponível no painel administrativo do PradaPay.

Quais os status possíveis?

  • PAID_OUT: Pagamento concluído
  • WAITING_FOR_APPROVAL: Pagamento pendente
  • DECLINED: Pagamento recusado