Utilização das APIs

Requisitos de Autenticação

Para utilizar a Integração Direta, é obrigatório fornecer um certificado e uma chave. Esses elementos de segurança são necessários para garantir a autenticidade e a segurança das transmissões de dados, e devem ser incluídos em todas as requisições.

URL Base

A URL base utilizada na Integração Direta é diferente da integração Parceria Cora. Certifique-se de utilizar a URL correta de acordo com a modalidade e ambiente de integração escolhido.

Token de Autenticação

Para cada requisição realizada utilizando a Integração Direta, é necessário incluir um token de autenticação. Temos mais informações sobre como obter este token, que deve ser utilizado em conjunto com o certificado, a chave e a URL base correta.

Bora pro código?

É possível utilizar todas nossas APIs transacionais (Boleto, Transferência, Pagamento, Extrato, etc.) através da Integração Direta. Para isso, basta incluir os requisitos de autenticação informados acima. Aqui está um exemplo de como gerar um boleto utilizando a modalidade Integração Direta:

Campo	Comentário
Método	POST
Endpoint	https://matls-clients.api.stage.cora.com.br/v2/invoices

curl --location 'https://matls-clients.api.stage.cora.com.br/v2/invoices' \
--cert '/Users/seunome/Documentos/cert_key_cora/certificate.pem'\
--key '/Users/seunome/Documentos/cert_key_cora/private-key.key'\
--header 'Idempotency-Key: dae73863-eb96-4b8c-8270-806edf3e5e57' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJPUXhETFpxNmFJb1EzS1Q0dWFEWWhQai1IUUVpMm5iNGl1WEdWV0diVWh3In0.eyJleHAiOjE2NjM5NzcyMDAsImlhdCI6MTY2Mzg5MDgwMCwianRpIjoiNTA0ZDQzOWMtMmU1OS00M2VjLTkxYWMtMGM2YzFhZDVhNTMxIiwiaXNzIjoiaHR0cHM6Ly9hdXRoLnN0YWdlLmNvcmEuY29tLmJyL3JlYWxtcy9jb3JhIiwic3ViIjoiYXBwLWJlY2tlcmVwIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiYXBwLWJlY2tlcmVwIiwiYWNyIjoiMSIsInNjb3BlIjoib2ZmbGluZV9hY2Nlc3MiLCJjbGllbnRJZCI6ImFwcC1iZWNrZXJlcCIsImNsaWVudEhvc3QiOiIxNzcuNDUuMTUwLjE0NSIsImNsaWVudEFkZHJlc3MiOiIxNzcuNDUuMTUwLjE0NSJ9.bT3jNRJOdTUJjvfwfP-Cz_Gm3XlKsiqI8TOZzoVkmuM7cJpb2YZRW5nAFfoPArfaCsgJoefSUdl46kSy1siQaPGXo0lXI3oSxnvlfsNZgZMgDazIxNaIdnGkVKlwOarQAFwFlbdO5twD8_gDHiBlC3xRVb5rwSHnKNOzdfk4Oa_9bPef3zFOTk7ijnGjdguru0LLvr-dvrYzcPddosfew37tgDrXQDD_JT52298M_qwwKjfQeykQg3O83zDmtXCccVKmxS-PHEeL3OSDgGxIDpTvYf91CGdcP1K66VIav5ufTbi5GUn_LivAD_5apasri7jrRgsHcH__a45PgWqrGw' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "meu_id",
    "customer": {
        "name": "Fulano da Silva",
        "email": "[email protected]",
        "document": {
            "identity": "34052649000178",
            "type": "CNPJ"
        },
        "address": {
            "street": "Rua Gomes de Carvalho",
            "number": "1629",
            "district": "Vila Olímpia",
            "city": "São Paulo",
            "state": "SP",
            "complement": "N/A",
            "zip_code": "00111222"
        }
    },
    "services": [{
        "name": "Nome do serviço",
        "description": "Descrição do serviço",
        "amount": 25000
    }],
    "payment_terms": {
        "due_date": "2024-08-25",
        "fine": {
            "amount": 500
        },
        "interest": {
            "rate": 3.67
        },
        "discount": {
            "type": "PERCENT",
            "value": 1.5
        }
    }
}'

Note que os campos descritos no corpo da requisição funcionam da mesma forma que os campos descritos na seção de Emissão de boleto registrado.

Opa, agora é hora do lanche! Sim, finalizamos a etapa de utilização das APIs na integração direta