Postback

Quando é utilizado?

O postback é utilizado para envio de status e informações adicionais após o fluxo do pedido.

Exemplos

• Fluxos que utilizam Antifraude e que costumam não ter retorno da aprovação do pagamento em tempo real.
• Envio de informações adicionais do pedido como o id de uma assinatura.

Modelo Postback - "Status" + "Informações Adicionais"

Método

• POST

Campos esperados (JSON)

• status - int.

http://gateway-postback.fbits.net/api/Custom/{chave_transacao}

No campo Chave_transação, será inserida a chave única enviada no request

Esse campo recebe o nome de Chave e está em formato GUID.

chave":"f50dc736-14cc-4e09-b7df-f2f5836ed095"

Segue evidenciado no trecho do código abaixo:

{
    "id": 189539,
    "loja": "Nome da Loja",
   >>> "chave": "2D39FE37-611E-4015-1AF6-F62A2223B8D7", <<<
    "pedido": 41282742,
    "frete": 13.27,
    "desconto": 0,
    "total": 130.79,
    "primeiroPedidoAssinatura": false,
    "assinatura": {
        "id": 1,
        "tipo": "recorrencia"
    },

Exemplo de utilização

JSON

{
  "status": 1 ,
	"informacoesAdicionais": [
	{
		"Nome": "Teste1",
		"Valor": "Valor1"
	},
	{
		"Nome": "Teste2",
		"Valor": "Valor2"
	}						
	]
}

{
  "status": 2,
  "informacoesAdicionais": [
	{
		"Nome": "Teste3",
		"Valor": "Valor3"
	}					
	]
}

{
  "status": 3 
}

{
  "status": 4 
}

Confira, na tabela abaixo, a explicação de cada Id de status e sua respectiva ação:

Id
1	Aguardando pagamento	Mantém o pedido com o status Aguardando Pagamento.
2	Não autorizado	Atualiza o pedido para Cancelado/Negado.
3	Pago	Atualiza o pedido para Pago.
4	Autorizado	Atualiza o status do pedido para Autorizado na plataforma. Usado em processamento Two-steps (Autorização separada da Captura).

---

Modelo Postback - Apenas "Informações Adicionais"

Método

• POST

Campos esperados (JSON)

• informacoesAdicionais - lista.

Passando a chave única da transação:

http://gateway-postback.fbits.net/api/Custom/informacoesadicionais/{chave_transacao}

Esse campo recebe o nome de Chave e está em formato GUID.

chave":"f50dc736-14cc-4e09-b7df-f2f5836ed095"

Passando o Id da transação:

http://gateway-postback.fbits.net/api/custom/informacoesadicionais/idTransacao/45879078

Exemplo de requisição

json

{
    "informacoesAdicionais": [
        {
            "nome": "Nome3",
            "valor": "Teste"
        },
        {
            "nome": "Nome4",
            "valor": "Teste"
        }
    ]
}

📘

Nesse modelo, não será necessário informar o campo status.

📘

Informamos que as Informações Adicionais devem ser enviadas no body da sua requisição.