Auto Authorization

Auto Autorização da transação do Safelink.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Auto Authorization

O Auto Authorization consiste em duas etapas:

  • Pré Autorização:
    Responsável por reservar o limite do cartão ou saldo do usuário no valor do Safelink.
  • Autorização:
    Caso esteja tudo correto, ou seja, haja limite ou saldo na conta e os dados estejam preenchidos corretamente, a transação será de fato autorizada e o pagamento será efetuado.

O usuário deve se atentar nas regras a seguir no momento em que for preencher os campos:

  • Regra do Produto:
    Deve ser inserido o nome produto que está sendo utilizando ao chamar a rota, no campo "product". Temos duas opções de preenchimento, sendo elas: PIXCOMMERCE e PARCELACONTA.
    Este campo deve ser preenchido apenas com uma dessas opções, obrigatoriamente. Caso contrário, será retornada uma mensagem de erro.

  • Hash Itens:
    Caso o seu Safelink tenha produtos, deve ser feito a conversão do Json dos itens para Base64, depois para string.
    Exemplo de Json do Hash Itens:

    {
      "max_installments":"1",
      "qtdMaxParcelas":"12",
      "flag_frete":true,
      "valor_frete":5.00,
      "items":[
        {
          "item_id":"001",
          "item_quantity":1,
          "item_name":"Item de Exemplo",
          "item_discount":0,
          "item_description":"Descrição do Item",
          "item_price":7.5
        },
        {
          "item_id":"007",
          "item_quantity":1,
          "item_name":"Item 2",
          "item_discount":0,
          "item_description":"Descrição do Item 2",
          "item_price":7.5
        }
      ],
      "dados_cliente":{
        "nome":"Nome Cliente",
        "cpf_cnpj":"12312312312",
        "email":"",
        "celular":"5585999999999",
        "cep":"60123-123",
        "logradouro":"Rua Exemplo",
        "numero":"123",
        "bairro":"Bairro Exemplo",
        "cidade":"Cidade Exemplo",
        "estado":"Estado Sigla",
        "complemento":"Complemento Exemplo",
        "ponto_referencia":"Ponto de Referencia Exemplo"
      }
    }
    

    Ao converter para Base64 deve ficar destá forma:

    ewogICJtYXhfaW5zdGFsbG1lbnRzIjoiMSIsCiAgInF0ZE1heFBhcmNlbGFzIjoiMTIiLAogICJmbGFnX2ZyZXRlIjp0cnVlLAogICJ2YWxvcl9mcmV0ZSI6NS4wMCwKICAiaXRlbXMiOlsKICAgIHsKICAgICAgIml0ZW1faWQiOiIwMDEiLAogICAgICAiaXRlbV9xdWFudGl0eSI6MSwKICAgICAgIml0ZW1fbmFtZSI6Ikl0ZW0gZGUgRXhlbXBsbyIsCiAgICAgICJpdGVtX2Rpc2NvdW50IjowLAogICAgICAiaXRlbV9kZXNjcmlwdGlvbiI6IkRlc2NyacOnw6NvIGRvIEl0ZW0iLAogICAgICAiaXRlbV9wcmljZSI6Ny41CiAgICB9LAogICAgewogICAgICAiaXRlbV9pZCI6IjAwNyIsCiAgICAgICJpdGVtX3F1YW50aXR5IjoxLAogICAgICAiaXRlbV9uYW1lIjoiSXRlbSAyIiwKICAgICAgIml0ZW1fZGlzY291bnQiOjAsCiAgICAgICJpdGVtX2Rlc2NyaXB0aW9uIjoiRGVzY3Jpw6fDo28gZG8gSXRlbSAyIiwKICAgICAgIml0ZW1fcHJpY2UiOjcuNQogICAgfQogIF0sCiAgImRhZG9zX2NsaWVudGUiOnsKICAgICJub21lIjoiTm9tZSBDbGllbnRlIiwKICAgICJjcGZfY25waiI6IjEyMzEyMzEyMzEyIiwKICAgICJlbWFpbCI6IiIsCiAgICAiY2VsdWxhciI6IjU1ODU5OTk5OTk5OTkiLAogICAgImNlcCI6IjYwMTIzLTEyMyIsCiAgICAibG9ncmFkb3VybyI6IlJ1YSBFeGVtcGxvIiwKICAgICJudW1lcm8iOiIxMjMiLAogICAgImJhaXJybyI6IkJhaXJybyBFeGVtcGxvIiwKICAgICJjaWRhZGUiOiJDaWRhZGUgRXhlbXBsbyIsCiAgICAiZXN0YWRvIjoiRXN0YWRvIFNpZ2xhIiwKICAgICJjb21wbGVtZW50byI6IkNvbXBsZW1lbnRvIEV4ZW1wbG8iLAogICAgInBvbnRvX3JlZmVyZW5jaWEiOiJQb250byBkZSBSZWZlcmVuY2lhIEV4ZW1wbG8iCiAgfQp9
    
  • Request JSON:
    Este campo contém algumas informações do Safelink em JSON, abaixo temos um exemplo de como deve ser montado e preenchido este campo.

    {
      "address":"Rua Exemplo",
      "amount":20,
      "brand":"",
      "card_holder_name":"",
      "card_token":"12345Q9RQUW6Z123453dJ7NpO1234",
      "city":"Cidade de Exemplo",
      "client_email":"",
      "client_name":"Nome Cliente",
      "client_phone":"5585999999999",
      "complement":"Apto 123",
      "cpf_cnpj_holder":"12312312312",
      "description":"",
      "expiration_month":"",
      "expiration_year":"",
      "hash_itens":"ewogICJtYXhfaW5zdGFsbG1lbnRzIjoiMSIsCiAgInF0ZE1heFBhcmNlbGFzIjoiMTIiLAogICJmbGFnX2ZyZXRlIjp0cnVlLAogICJ2YWxvcl9mcmV0ZSI6NS4wMCwKICAiaXRlbXMiOlsKICAgIHsKICAgICAgIml0ZW1faWQiOiIwMDEiLAogICAgICAiaXRlbV9xdWFudGl0eSI6MSwKICAgICAgIml0ZW1fbmFtZSI6Ikl0ZW0gZGUgRXhlbXBsbyIsCiAgICAgICJpdGVtX2Rpc2NvdW50IjowLAogICAgICAiaXRlbV9kZXNjcmlwdGlvbiI6IkRlc2NyacOnw6NvIGRvIEl0ZW0iLAogICAgICAiaXRlbV9wcmljZSI6Ny41CiAgICB9LAogICAgewogICAgICAiaXRlbV9pZCI6IjAwNyIsCiAgICAgICJpdGVtX3F1YW50aXR5IjoxLAogICAgICAiaXRlbV9uYW1lIjoiSXRlbSAyIiwKICAgICAgIml0ZW1fZGlzY291bnQiOjAsCiAgICAgICJpdGVtX2Rlc2NyaXB0aW9uIjoiRGVzY3Jpw6fDo28gZG8gSXRlbSAyIiwKICAgICAgIml0ZW1fcHJpY2UiOjcuNQogICAgfQogIF0sCiAgImRhZG9zX2NsaWVudGUiOnsKICAgICJub21lIjoiTm9tZSBDbGllbnRlIiwKICAgICJjcGZfY25waiI6IjEyMzEyMzEyMzEyIiwKICAgICJlbWFpbCI6IiIsCiAgICAiY2VsdWxhciI6IjU1ODU5OTk5OTk5OTkiLAogICAgImNlcCI6IjYwMTIzLTEyMyIsCiAgICAibG9ncmFkb3VybyI6IlJ1YSBFeGVtcGxvIiwKICAgICJudW1lcm8iOiIxMjMiLAogICAgImJhaXJybyI6IkJhaXJybyBFeGVtcGxvIiwKICAgICJjaWRhZGUiOiJDaWRhZGUgRXhlbXBsbyIsCiAgICAiZXN0YWRvIjoiRXN0YWRvIFNpZ2xhIiwKICAgICJjb21wbGVtZW50byI6IkNvbXBsZW1lbnRvIEV4ZW1wbG8iLAogICAgInBvbnRvX3JlZmVyZW5jaWEiOiJQb250byBkZSBSZWZlcmVuY2lhIEV4ZW1wbG8iCiAgfQp9",
      "installments":1,
      "ip":"",
      "neighborhood":"Bairro Exemplo",
      "number":123,
      "product":"PIXCOMMERCE",
      "reference":"SA912345o2cbU",
      "request_json":"",
      "state":"Sigla Estado",
      "threedsecure":{
        "device":{
          "colorDepth":1,
          "screenHeight":912,
          "screenWidth":432
        },
        "userAgent":""
      },
      "url_failure":"",
      "url_success":"",
      "usuario_id":0,
      "zip_code":"60123-123"
    }
    

É necessário passar o Token API do estabelecimento no header "Authorization", e no "Content-Type" preenchê-lo com o valor do conteúdo que está sendo enviado, neste caso usamos "application/json".

Abaixo temos um exemplo de como inserir estes dados usando JSON.

{
    "Content-Type": "application/json",
    "Authorization": "Bearer 125SEBXXXXXX20150821"
}
Body Params
string
required

Hash dos itens inseridos no Safelink.

string
required

JSON contendo algumas informações do Safelink.

float
required

Valor do Safelink.

string
required

Descrição do Safelink.

string
required

Reference do Safelink.

string
required

Token gerado ao salvar o cartão no cofre.

string
required

Nome do cliente.

string
required

Email do cliente.

string
required

Telefone do cliente.

int32
required

Parcelas do Safelink.

string
required

Bandeira do cartão.

string
required

Logradouro.

int32
required

Número da residência.

string
required

Complemento do endereço.

string
required

Bairro.

string
required

Cidade.

string
required

Estado.

string
required

CEP do endereço.

string
required

Nome do titular do cartão.

string
required

Número do cartão.

string
required

Mês de validade do cartão.

string
required

Ano de validade do cartão.

string
required

Código de segurança do cartão.

string
required

Cpf ou Cnpj do titular do cartão.

string
required

Endereço de IP do dispositivo utilizado durante a transação.

int32
required

Id do usuário.

threedsecure
object
required
string
required

Link para a tela de sucesso.

string
required

Link para a tela de falha.

string
required

Produto utilizado.

string
required

Cartão salvo na carteira digital.

string
required

Número do whatsapp do cliente.

Headers
string
required
Defaults to Bearer 125SEBXXXXXX20150821

Header no qual o valor é o Token Api do estabelecimento. Ex.: Bearer $TOKEN_API

string
required
Defaults to application/json

Header que recebe o tipo do conteúdo a ser enviado. Ex.: application/json

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json