SDK de crédito | Documentação sandbox

SDK de crédito

Simulação de venda crédito na maquineta virtual do portal (parcelas, senha e comprovante).

Base

Somente no portal Software House

Autenticação

Sessão da Software House (cookie). Não há Bearer público para a maquineta.

Particularidades só no sandbox

Não existe endpoint público ConfraOnline/Confrapix para a maquineta.
A venda fica isolada por tenant e não movimenta valor real.
Comprovante (NSU/autorização) só aparece em vendas aprovadas.

Simular venda no crédito

Fluxo local da maquineta: modalidade, valor, cartão, senha e resultado.

Endpoint de teste

Maquineta virtual (simulação no portal)

POST/software-house/maquineta

Sessão Software House (cookie)

Não há endpoint público ConfraOnline/Confrapix para a maquineta. A venda é simulada só na Software House.

Parâmetros

modality obrigatório · "credito"
Modalidade crédito.
amount obrigatório · number
Valor da venda.
installments obrigatório · number
Parcelas (≥ 1).
brand obrigatório · string
Bandeira do cartão.
pan obrigatório · string
Número do cartão de teste (só últimos 4 são persistidos).
password obrigatório · string
Senha do cartão (armazenada mascarada).

Respostas

result.status approved|declined
Resultado da simulação.
result.receipt object
NSU, authCode, valor, bandeira e last4 quando aprovada.
result.steps array
Etapas percorridas na maquineta virtual.

Só no sandbox

Particularidade só no sandbox do portal: UI guiada por etapas e comprovante visual.
PAN e senha nunca voltam em claro nas listagens.

Exemplo de response

{
  "id": "…",
  "result": {
    "status": "approved",
    "receipt": { "nsu": "…", "authCode": "…", "modality": "credito", "statusLabel": "Aprovada" }
  }
}