Pagamento com Cartão

Cobre seu cliente via cartão de crédito ou débito. O processamento é feito em tempo real e você recebe o status da transação na resposta.

Endpoint

POST https://isolutionpay.com/api/card

Campos

Obrigatórios

Campo	Tipo	Descrição
amount	inteiro	Valor em centavos. Ex: `5000` = R$ 50,00
customer.name	string	Nome completo do pagador
customer.email	string	E-mail do pagador
customer.document	string	CPF do pagador (somente dígitos)
credit_card.number	string	Número do cartão (somente dígitos)
credit_card.holder_name	string	Nome impresso no cartão
credit_card.exp_month	inteiro	Mês de vencimento (1–12)
credit_card.exp_year	inteiro	Ano de vencimento (4 dígitos, ex: `2028`)
credit_card.cvv	string	Código de segurança

Opcionais

Campo	Tipo	Descrição
installments	inteiro	Número de parcelas (1–12)
description	string	Descrição da cobrança (máx. 120 caracteres)
customer.phone	string	Telefone do pagador (somente dígitos)

Exemplo — crédito à vista

curl -X POST https://isolutionpay.com/api/card \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer isolutionpay_sk_SUA_CHAVE_AQUI" \
  -d '{
    "amount": 9990,
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com",
      "document": "12345678900"
    },
    "credit_card": {
      "number": "4111111111111111",
      "holder_name": "JOAO SILVA",
      "exp_month": 12,
      "exp_year": 2028,
      "cvv": "123"
    }
  }'

Exemplo — parcelado

curl -X POST https://isolutionpay.com/api/card \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer isolutionpay_sk_SUA_CHAVE_AQUI" \
  -d '{
    "amount": 50000,
    "installments": 6,
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com",
      "document": "12345678900"
    },
    "credit_card": {
      "number": "4111111111111111",
      "holder_name": "JOAO SILVA",
      "exp_month": 12,
      "exp_year": 2028,
      "cvv": "123"
    }
  }'

Resposta

{
  "success": true,
  "txid": "a1b2c3d4-...",
  "status": "CONCLUIDA",
  "cardStatus": "captured"
}

Campo	Descrição
txid	ID da transação. Salve para consultar depois.
status	`CONCLUIDA`, `RECUSADA` ou `pending`
cardStatus	Status detalhado da adquirente

Códigos de erro comuns

HTTP	Mensagem	Causa
400	amount deve ser inteiro em centavos	amount enviado como `"99.90"` (string)
400	Dados do cartão inválidos	Número, CVV ou validade incorretos
402	Transação recusada	Cartão sem limite, bloqueado, etc.
429	Limite de requisições atingido	Muitas tentativas — aguarde 1 minuto

Verificar Pagamento Cashout (Saque via PIX)