Aqui será abordado todo tipo de comunicação entre o sistema da Grafeno e o sistema do parceiro.
Confirmação
Após a criação de uma transferência, antes de sua real efetuação, é feita uma confirmação usando a URL cadastrada no token.
A confirmação é enviada logo após a criação da transferência. É efetuado um POST com os seguintes parâmetros:
Body Params
| Parâmetro | Descrição | Formato |
|---|---|---|
| signature | Campo criptografado *. | string |
| digest | É usado para verificar a signature. | string |
| kind | Tipo de webhook | string |
| data.api_partner_transaction_uuid | UUID enviado pelo usuário na criação. | string |
| data.beneficiary | Verificar abaixo os atributos do beneficiário. | object |
| data.value | Valor da transferência. | string |
*Criptografado usando o texto: confirmation-api_partner_transaction_uuid onde api_partner_transaction_uuid é o informado pelo usuário na criação.
Atributos do Beneficiário (Confirmação e Notificações)
| Parâmetro | Descrição | Formato |
|---|---|---|
| agency | Agência da conta para onde será enviada a transferência. | string |
| account | Número da conta para onde será enviada a transferência. | string |
| bank_code | Código do banco para onde será enviada a transferência. | string |
Notificações
As notificações são enviadas para o callback_url na hora da criação da transferência.
Body Params
| Parâmetro | Descrição | Formato |
|---|---|---|
| signature | * Campo criptografado | string |
| digest | Digest é usado para verificar a signature | string |
| kind | Tipo do webhook | string |
| data.api_partner_transaction_uuid | UUID enviado pelo usuário na criação | string |
| data.resource | Tipo de recurso da notificação, neste caso, transfer_request | string |
| data.status | Status atual da transferência | string |
| data.message | Mensagem de retorno | string |
| data.reject_reason | Motivo pelo qual a transferência foi rejeitada (apenas quando rejeitada) | string |
Criptografado usando o texto:
status-api_partner_transaction_uuidondeapi_partner_transaction_uuidé o informado pelo usuário na criação e o status é o status enviado nodata.
Os tipos de status são:
autorizado-pelo-aprovador: Transferência autorizada pelo aprovador.rejeitado-pelo-aprovador: Transferência rejeitada pelo aprovador.transferencia-enviada-com-sucesso: Transferencia enviada com sucesso.erro-ao-enviar-transferencia: Erro ao enviar a transferênicia.