🔛Criação de Transações: Cartão de Crédito, PIX e Cripto

Este endpoint é versátil e permite a criação de transações utilizando diferentes métodos de pagamento, como cartão de crédito, PIX e criptomoedas.

Ao especificar o método de pagamento adequado, você pode processar pagamentos diretamente ou criar transações pendentes para captura posterior.

Cria uma transação, de crédito pix ou cripto

Endpoint para criar uma transação Por padrão cria para cartão de crédito, mas pode criar transação pix ou cripto, usando o campo payment_method com os valores credit,pix,cripto Pode ser criada já fazendo o pagamento caso seja uma transação de crédito(se passados os dados do cartão) Também pode ser criada uma transação de crédito sem capturar o valor, ou seja, não efetivar o pagamento (campo capture=false) Nesse caso pode ser feita a captura manualmente pelo endpoint /capture ou efetivado o pagamento no envpoint /pay

POSThttps://gws.bemfacil.com.br/transaction

Body

application/json

documentstring

CPF do pagador

namestring

Nome do pagador

titlestring

Título da compra

descriptionstring

Descritivo da compra

amountnumber

Valor do pagamento em centavos

emailstring

Email do pagador

payment_methodstring

Meio de pagamento [credit|pix|crypto]

installmentsnumber

Número de parcelas do pagamento

captureboolean

Flag indicando se o pagamento deve ser capturado automaticamente

limit_datestring

Data limite para o pagamento

Response

201400500

Pagamento realizado com sucesso

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://gws.bemfacil.com.br/transaction', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "document": "40404040411",
      "amount": 10,
      "payment_method": "credit",
      "installments": 1
    }),
});
const data = await response.json();

Respostas Esperadas:

• 201 Created: Indica que a transação foi criada com sucesso e o pagamento foi processado ou está pendente para captura, dependendo do valor do campo capture.

• 400 Bad Request: A requisição é inválida. Isso geralmente ocorre devido à falta de informações necessárias ou ao formato incorreto dos dados enviados.

• 500 Internal Server Error: Um erro ocorreu no servidor. Isso pode ser temporário; tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte técnico.

Notas de Segurança:

• Assegure-se de que todas as informações do pagador sejam tratadas com confidencialidade e em conformidade com as regulamentações de proteção dedados aplicáveis.

• Todas as transações devem ser feitas em um ambiente seguro e criptografado para proteger as informações financeiras e pessoais do usuário.

---

Faz o pagamento de uma transação de crédito criada

Endpoint para pagar uma transação passando dos dados do cartão ou token Se a transação foi criada com os dados do cartão não é necessário passar novamente Se a transação foi /criada sem captura (campo capture=false), esse endpoint confirma e efetiva o pagamento

PUThttps://gws.bemfacil.com.br/transaction/pay/{id}

Path parameters

id*string

Identificador único da transação

Body

application/json

cardobject

Response

200400500

Pagamento realizado com sucesso

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://gws.bemfacil.com.br/transaction/pay/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Faz a captura de uma transação de crédito criada

Endpoint para capturar uma transação passando dos dados do cartão (sem efetivar) Para usar esse endpoint a transação deve ter sido criada sem captura (campo capture=false) Nesse endpoint será apenas capturado o valor sem efetivar a transação, após isso é necessário ainda chamar o endpoint /pay

PUThttps://gws.bemfacil.com.br/transaction/capture/{id}

Path parameters

id*string

Identificador único da transação

Body

application/json

cardobject

Response

200400500

Pagamento capturado com sucesso

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://gws.bemfacil.com.br/transaction/capture/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Consulta uma transação pelo id

Endpoint para retornar as informações da transação dessa forma é possível consultar o status e possíveis atualizações

GEThttps://gws.bemfacil.com.br/transaction/{id}

Path parameters

id*string

Identificador único da transação

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://gws.bemfacil.com.br/transaction/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();