Como realizar a autenticação sendo Parceiro na API?
Ficou com dúvidas enquanto estava fazendo a integração entre o cel_cash e seu sistema próprio como parceiro?
Para realizar a geração do token para utilizar os outros métodos da API, você como parceiro, terá que informar dois headers no endpoint de geração do token.
O primeiro, é referente ao cliente que está utilizando seu sistema, que é o header de Authorization: Basic, codificando em base64 o ID e Hash, separados por dois pontos, desse cliente. (ID:HASH)
Esse header Authorization: Basic, é que vai indicar em qual cliente será realizada a autenticação na API, para gerar as cobranças no cel_cash, listar as cobranças cadastradas no cel_cash, etc.
O segundo, é referente a sua conta de parceiro no cel_cash, é com ele que será realizado o vínculo da cobrança gerada no seu cliente com sua conta de parceiro. É o header AuthorizationPartner.
Nele, você também passará o ID e Hash, separado por dois pontos, codificado em base64. Só que esse ID e Hash, será da conta da sua empresa no cel_cash, sempre fixo.
Com isso, o ID e Hash do Authorization: Basic, irá variar para cada cliente que for utilizar o seu sistema. Já o ID e Hash do AuthorizationPartner, sempre será o mesmo, que é o da sua conta no cel_cash.
Ambos ID e Hash são obtidos no Módulo de Webservice, tanto da conta do seu cliente, como o da sua conta de parceiro.
Com o Token gerado, nos outros endpoints, você irá passar apenas um header com: Authorization: Bearer (e o token gerado)
EXEMPLOS DA AUTENTICAÇÃO PARA GERAR O TOKEN COMO PARCEIRO:
Gerando o token para o seguinte cliente que irá utilizar a integração pelo seu sistema:
ID do cliente no cel_cash: 81898
Hash do cliente no cel_cash: 123155156
ID da sua conta de parceiro no cel_cash: 1234
Hash da sua conta de parceiro no cel_cash: 123456789
Authorization: Basic base64(81898:123155156)
AuthorizationPartner: base64(1234:123456789)
--------------------------------------------------------------------------
Gerando o token para o seguinte cliente que irá utilizar a integração pelo seu sistema:
ID do cliente no cel_cash: 198
Hash do cliente no cel_cash: 189189189
ID da sua conta de parceiro no cel_cash: 1234
Hash da sua conta de parceiro no cel_cash: 123456789
Authorization: Basic base64(198:189189189)
AuthorizationPartner: base64(1234:123456789)
OBS: Em ambiente de produção, não é possível utilizar o mesmo ID e Hash como cliente e parceiro, caso houver uma geração de cobrança na mesma conta informada no Authorization: Basic e no AuthorizationPartner, o vínculo não será registrado.
A geração da cobrança ocorrerá normalmente, só o vínculo de parceria que não irá funcionar.