## Consultar cartão pelo número e valida a senha

1. [Autenticar em Cartões na API de Autenticar em Cartões](#autentica)
2. [Reautenticar (refresh de sessão) em Cartões na API de Reautenticar em Cartões](#reautentica)
3. [Busca o cartão pelo número do cartão](#get-card)
4. [Valida senha do cartão](#check-password)
5. [Busca produto do cartão (se cartão titular additional = false)](#produto)
6. Busca Cooperado PF ou PJ
6.1 [Busca cadastro do cooperado PF (produto.corporate = false ou additional = true)](#pf)
6.2 [Busca cadastro do cooperado PJ (produto.corporate = true)](#pj)

### <a id="autentica"></a>Endpoint que autentica em cartões
**POST**:
https://api.test.cartoesunicred.com.br/auth/agw

**Headers:**

Content-Type
Exemplo: application/x-www-form-urlencoded
Form URL Encoded:

grant_type=password
client_id=unicred
username=user
password=******

**Retornos:**

200 (Ok)
401 (Unauthorized)
500 (Internal Server Error)
Exemplos de retorno:

Retorna 200 quando autentica com sucesso

**Body de retorno:**

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiMzI0ZGNlOGUtNjliNS00NWFlLWE3ZDAtMDIzMTAzNmUzODk3IiwiaXNzIjoiaHR0cDovL2F1dGgudGVzdC5jYXJ0b2VzdW5pY3JlZC5jb20uYnIvYXV0aC9yZWFsbXMvYXBpLWdhdGV3YXkiLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiYWE1OWMyOWItNDdiZi00ODMwLTgyNWMtNGIzODU1ODg4ZmYwIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoidW5pY3JlZCIsInNlc3Npb25fc3RhdGUiOiJhODJkMjc5Mi05NzEzLTRjYzUtYTk2My0wY2MwMTkwZWFlMzUiLCJhY3IiOiIxIiwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwiZ2V0X3Jld2FyZHNfYmFsYW5jZSIsImdldF9jdXN0b21lcl9kb2N1bWVudCIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiZW1haWxfdmVyaWZpZWQiOmZhbHNlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJjYW5haXNfdXNlciJ9.YNtHl62ZoOIGkIr5FwMSKmAlzkGzjZ396JLQfa_xhy-LnuNYTFR7w6FHjdlQMfTE9r_Db7NTLwpQXFQeqGnPy5KqZ4kpXkgop924bHty_3gjRSJy-yeYCL_ZCYtk7AzWmIfdKuj5xqd129A-QU9ibiHIDMx0iH6Szdy8pQZPrdB0RVul8eqywDF4Smhpd9wjEEQYVjg9KPPr3Bmxrmr1xjfdbElbCSrZ83Vy6z_PHvY4l4fZ19rlHA8Z-XPfmY-n0zAqdZ4cpRov",
  "expires_in": 300,
  "refresh_expires_in": 1800,
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIzMzgzNDI5OS05ZTFlLTQ0NWItODJjMC1jNWQ3NmQ0NzQ5MjIifQ.eyJleHAiOjE2MTM2NjEwNzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiOWM0ZWM5Y2YtMTRkYy00NzE0LThiMmQtMzM5YmFhMTIyMTZkIiwiaXNzIjoiaHR0cDovL2F1dGgudGVzdC5jYXJ0b2VzdW5pY3JlZC5jb20uYnIvYXV0aC9yZWFsbXMvYXBpLWdhdGV3YXkiLCJhdWQiOiJodHRwOi8vYXV0aC50ZXN0LmNhcnRvZXN1bmljcmVkLmNvbS5ici9hdXRoL3JlYWxtcy9hcGktZ2F0ZXdheSIsInN1YiI6ImFhNTljMjliLTQ3YmYtNDgzMC04MjVjLTRiMzg1NTg4OGZmMCIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJ1bmljcmVkIiwic2Vzc2lvbl9zdGF0ZSI6ImE4MmQyNzkyLTk3MTMtNGNjNS1hOTYzLTBjYzAxOTBlYWUzNSI",
  "token_type": "bearer",
  "not-before-policy": 0,
  "session_state": "a82d2792-9713-4cc5-a963-0cc0190eae35",
  "scope": "email profile"
}

**Exemplo curl:**

curl --location 'https://api.test.cartoesunicred.com.br/auth/agw' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'client_id=unicred' \
--data-urlencode 'username=aec_user' \
--data-urlencode 'password=xyxyxyxyxyx'

## <a id="reautentica"></a>Endpoint que reautentica em cartoes

**POST:**
https://api.test.cartoesunicred.com.br/auth/agw

**Headers:**

Content-Type
Exemplo: application/x-www-form-urlencoded
Form URL Encoded:

grant_type=refresh_token
client_id=unicred
refresh_token=eyJhbGciOiJIUzI1NiIsInR5cCI…

**Retornos:**

200 (Ok)
401 (Unauthorized)
500 (Internal Server Error)
Exemplos de retorno:

Retorna 200 quando autentica com sucesso

**Body de retorno:**

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiMzI0ZGNlOGUtNjliNS00NWFlLWE3ZDAtMDIzMTAzNmUzODk3IiwiaXNzIjoiaHR0cDovL2F1dGgudGVzdC5jYXJ0b2VzdW5pY3JlZC5jb20uYnIvYXV0aC9yZWFsbXMvYXBpLWdhdGV3YXkiLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiYWE1OWMyOWItNDdiZi00ODMwLTgyNWMtNGIzODU1ODg4ZmYwIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoidW5pY3JlZCIsInNlc3Npb25fc3RhdGUiOiJhODJkMjc5Mi05NzEzLTRjYzUtYTk2My0wY2MwMTkwZWFlMzUiLCJhY3IiOiIxIiwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9mZmxpbmVfYWNjZXNzIiwiZ2V0X3Jld2FyZHNfYmFsYW5jZSIsImdldF9jdXN0b21lcl9kb2N1bWVudCIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiZW1haWxfdmVyaWZpZWQiOmZhbHNlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJjYW5haXNfdXNlciJ9.YNtHl62ZoOIGkIr5FwMSKmAlzkGzjZ396JLQfa_xhy-LnuNYTFR7w6FHjdlQMfTE9r_Db7NTLwpQXFQeqGnPy5KqZ4kpXkgop924bHty_3gjRSJy-yeYCL_ZCYtk7AzWmIfdKuj5xqd129A-QU9ibiHIDMx0iH6Szdy8pQZPrdB0RVul8eqywDF4Smhpd9wjEEQYVjg9KPPr3Bmxrmr1xjfdbElbCSrZ83Vy6z_PHvY4l4fZ19rlHA8Z-XPfmY-n0zAqdZ4cpRov",
  "expires_in": 300,
  "refresh_expires_in": 1800,
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIzMzgzNDI5OS05ZTFlLTQ0NWItODJjMC1jNWQ3NmQ0NzQ5MjIifQ.eyJleHAiOjE2MTM2NjEwNzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiOWM0ZWM5Y2YtMTRkYy00NzE0LThiMmQtMzM5YmFhMTIyMTZkIiwiaXNzIjoiaHR0cDovL2F1dGgudGVzdC5jYXJ0b2VzdW5pY3JlZC5jb20uYnIvYXV0aC9yZWFsbXMvYXBpLWdhdGV3YXkiLCJhdWQiOiJodHRwOi8vYXV0aC50ZXN0LmNhcnRvZXN1bmljcmVkLmNvbS5ici9hdXRoL3JlYWxtcy9hcGktZ2F0ZXdheSIsInN1YiI6ImFhNTljMjliLTQ3YmYtNDgzMC04MjVjLTRiMzg1NTg4OGZmMCIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJ1bmljcmVkIiwic2Vzc2lvbl9zdGF0ZSI6ImE4MmQyNzkyLTk3MTMtNGNjNS1hOTYzLTBjYzAxOTBlYWUzNSI",
  "token_type": "bearer",
  "not-before-policy": 0,
  "session_state": "a82d2792-9713-4cc5-a963-0cc0190eae35",
  "scope": "email profile"
}

**Exemplo curl:**

curl --location 'https://api.test.cartoesunicred.com.br/auth/agw' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'client_id=unicred' \
--data-urlencode 'refresh_token=ey...'

#
### <a id="get-card"></a>Endpoint que busca as informações de um cartão pela trilha.

**GET**:
api.test.cartoesunicred.com.br/v1/cards/card-track

**Headers:**
* Authorization
* **Exemplo:** eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiM **(required)**
* Traffic-Code
* **Exemplo:** 136 **(required)**
* Card-Track
* **Exemplo:** 4179583037472562= **(required)**
* X-Api-Key
* **Exemplo:** tvlNwSLXMx2henaVrcY8G7FzcBMGnoLJay9mbOFs **(required)**

**Retornos:**

- 200 (OK)
- 400 (Bad Request)
- 401 (Unauthorized)
- 404 (Not Found)
- 500 (Internal Server Error)
- 502 (Bad Gateway)

**Exemplos de retorno:**

*Retorna 200 quando uma conta cartão for encontrada.*

*Payload de resposta:*

{
  "uuid": "5dc41441-91b9-43a2-9659-cd601292f3a4",
  "lastFourNumbers": "3456",
  "printedName": "MARIA DA SILVA",
  "productUuid": "cd3d599d-17d0-4187-840b-5d40970ef477",
  "validThru": "2025-11-25T07:00:00",
  "additional": false,
  "automaticDebit": false,
  "firstBlock": false,
  "travelNotice": false,
  "dateLastChangeDueDay":"2020-02-02T22:00:00.000Z",
  "status": {
    "code": 1,
    "type": "ACTIVE",
    "description": "ACTIVATED"
  },
  "cardAccount": {
    "uuid": "c74bf86c-b641-4490-91ce-a76fceea7265",
    "organization": "27",
    "productChangeInProcess": false,
    "customerUuid": "8196feb0-ebc6-4db6-aa23-0a54387430ef",
    "accountNumber": "123456",
    "email": "[e-mail]"
  },
  "modality": "MULTIPLE",
  "securityLockUuid": "a9eddad8-9899-4a62-b094-6dfae049c083"
}

### <a id="check-password"></a>Endpoint que valida a senha criptograda do cartão

<div style="background-color:#FCF8E3;color:#8A6D3B;border-color:#FAEED2;border-style: solid;">
Observação: Para a chamada desse endpoint é necessário a utilização de uma chave pública para a critpografia da senha. Solicitar para a equipe VISA Unicred
</div>

</br>

**POST**:
api.test.cartoesunicred.com.br/v1/cards/card/{uuid}/check-password

**Headers:**
* Authorization
* **Exemplo:** eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiM **(required)**
* Traffic-Code
* **Exemplo:** 136 **(required)**
* X-Api-Key
* **Exemplo:** tvlNwSLXMx2henaVrcY8G7FzcBMGnoLJay9mbOFs **(required)**

**Path Param:**
* uuid (Uuid do cartão)
* **Exemplo:** be172072-4eb0-44b9-b454-87cae598aaf8

**Body:**
* password (Senha do cartão criptografada)
* **Exemplo:** k6pR5IqvoyOmUZgrS97KQernEF1OePSE5AmMAPcO6Hwfsvpq9PUMuE+8ioHzsDrRMIJdnrqtvfIu2rfQdxkJPGjb1IppjO0gz1u8h0tfevIEIBPZYday9mx0l9GBpShOo27VLJTI+wpYeoXB7sZVTrW1WAwNFl4VbBwsTosBUJD2YsEnlah8PQutGDMSu9TUFOgEsdPkmASOiCungCYEewKOi2PH57RNiBFKPNyhrVkKB9UqD7V9DU58EPJoGWqOWlaYIvlI9AAIQiC8Y4Dgc5jISkE60a0xqPcOSt+GEz2MYmdbat+aJUjAS8MFCuKiljMKl70dCyZz7dXeYKaIAA==

Exemplo:

{
    "password": "k6pR5IqvoyOmUZgrS97KQernEF1OePSE5AmMAPcO6Hwfsvpq9PUMuE+8ioHzsDrRMIJdnrqtvfIu2rfQdxkJPGjb1IppjO0gz1u8h0tfevIEIBPZYday9mx0l9GBpShOo27VLJTI+wpYeoXB7sZVTrW1WAwNFl4VbBwsTosBUJD2YsEnlah8PQutGDMSu9TUFOgEsdPkmASOiCungCYEewKOi2PH57RNiBFKPNyhrVkKB9UqD7V9DU58EPJoGWqOWlaYIvlI9AAIQiC8Y4Dgc5jISkE60a0xqPcOSt+GEz2MYmdbat+aJUjAS8MFCuKiljMKl70dCyZz7dXeYKaIAA=="
}

#### Obs: É possível errar apenas 3 vezes a senha do cartão, após o cartão será bloqueado.

**Retornos:**

- 200 (OK)
- 400 (Bad Request)
- 401 (Unauthorized)
- 404 (Not Found)
- 500 (Internal Server Error)
- 502 (Bad Gateway)

#
**Exemplos de retorno:**

**400**

- *Retorna 400 quando o header Authorization não é enviado.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "AUTHORIZATION_HEADER_NOT_RECEIVED",
      "message": "Authorization header must be informed"
    }
  ]
}

- *Retorna 400 quando o header Traffic-Code não é enviado.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "TRAFFIC_CODE_HEADER_NOT_RECEIVED",
      "message": "Traffic-Code header must be informed"
    }
  ]
}

- *Retorna 400 quando o payload password não é enviado ou é enviado em nulo/em branco.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "PASSWORD_INVALID_PAYLOAD_FIELD",
      "message": "password must not be blank"
    }
  ]
}

**422**

- *Retorna 422 quando o header Authorization é inválido.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "INVALID_AUTHORIZATION",
      "message": "Code not provided, unable to process request"
    }
  ]
}

- *Retorna 422 quando o header Authorization é inválido.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "INVALID_AUTHORIZATION",
      "message": "Error reading authorization token."
    }
  ]
}

- *Retorna 422 quando a senha é inválida/errada.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "WRONG_CARD_PASSWORD",
      "message": "Wrong card password."
    }
  ]
}

- *Retorna 422 quando o cartão ainda não possuí senha.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "CARD_WITHOUT_PASSWORD",
      "message": "Card without password."
    }
  ]
}

- *Retorna 422 quando o cartão é bloqueado por limite de tentativas.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "CARD_BLOCKED_BY_WRONG_PASSWORD",
      "message": "Card blocked by wrong password."
    }
  ]
}

- *Retorna 422 quando o cartão é excedeu o limite de tentativas.*

*Payload de resposta:*

{
  "errors": [
    {
      "code": "PASSWORD_RETRIES_LIMIT_EXCEEDED",
      "message": "Password retries limit exceeded."
    }
  ]
}

**Exemplo curl:**

curl --location 'https://api.test.cartoesunicred.com.br/v1/cards/card/60d06e41-b8a5-4af2-9b40-c3350642a661/check-password' \
--header 'Authorization: eyJ...' \
--header 'Content-Type: application/json' \
--header 'Traffic-code: 136' \
--header 'X-Api-Key: bAf...' \
--data '{
"password":"WoDR...."
}'

### <a id="produto"></a>Endpoint que busca um produto em cartões.
**GET:**
https://api.test.cartoesunicred.com.br/v1/cards/params/products/{uuid}

**Headers:**
* Authorization
* **Exemplo:** eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiM **(required)**
* Traffic-Code
* **Exemplo:** 136 **(required)**
* X-Api-Key
* **Exemplo:** tvlNwSLXMx2henaVrcY8G7FzcBMGnoLJay9mbOFs **(required)**

**Path Param:**
* uuid (Uuid do produto)
* **Exemplo:** be172072-4eb0-44b9-b454-87cae598aaf8

**Retornos**:

200 (No Content)
400 (Bad Request)
401 (Unauthorized)
404 (Not Found)
500 (Internal Server Error)
502 (Bad Gateway)
Exemplos de retorno:

Retorna 200 quando o(s) produto(s) é/são encontrado(s)

**Body de retorno:**

{
    "name": "Infinite",
    "type": "INFINITE",
    "description": "CARTÃO VISA INFINITE",
    "debitAllowed": true,
    "creditAllowed": true,
    "interestFee": 9.9,
    "deadLine": 10,
    "creditLine": "123",
    "creditLinePreApproved": "123",
    "creditLineLimitIncrease": "123",
    "processorInfo": {
        "productId": "1",
        "businessOriginId": "1",
        "linkedProductId": "2"
    },
    "corporate": false,
    "uuid": "7068c094-877a-4351-8c64-4a82abf759f2",
    "institution": "136",
    "organization": "9184",
    "descriptionContent": {
        "title": "Infinite Black",
        "description": "Um produto...",
        "reference": {
            "label": "Saiba mais: Teste edição",
            "url": "https://www.uni..."
        }
    },
    "billetInfo": {
        "beneficiaryCode": "162B62923A8B46CFB5E567A23E2D621A",
        "beneficiaryPortfolioVariation": 38869,
        "billetCode": 1,
        "beneficiaryAgency": "4371",
        "beneficiaryAccountNumber": "348473"
    },
    "layoutTemplate": {
        "emailBodyLayoutCode": 1,
        "pdfLayoutCode": 1,
        "emailBodyDebitAccountLayoutCode": 1,
        "pdfDebitAccountLayoutCode": 1,
        "emailBodyDebitAccountLiquidationLayoutCode": 1,
        "pdfDebitAccountLiquidationLayoutCode": 0,
        "emailBodyDebitAccountErrorLiquidationLayoutCode": 1,
        "pdfDebitAccountErrorLiquidationLayoutCode": 0,
        "emailBodyDetachedPaymentLayoutCode": 1,
        "pdfDetachedPaymentLayoutCode": 1
    },
    "rewardProgram": true,
    "rewardCampaign": {
        "invoiceClosingCode": "RS.COOP.INF.FECH",
        "invoiceLiquidationCode": "RS.COOP.INF.LIQ",
        "logo": null
    },
    "mainCardAnnuities": [
        {
            "uuid": "0265dc7f-25f5-4ef3-9f9e-39e0b92e7ca1",
            "monthlyAmount": 66.66,
            "conductorId": 66,
            "standard": true,
            "allowed": true
        }
    ],
    "additionalCardAnnuities": [
        {
            "uuid": "20a994db-83e4-4687-ad43-312db5571a4b",
            "monthlyAmount": 33.33,
            "conductorId": 33,
            "standard": true,
            "allowed": true
        }
    ],
    "annuityDiscount": {
        "loyaltyIndex": false,
        "minimumInvoiceAmount": 100,
        "discounts": [
            {
                "type": "INVOICE_EXPENSE",
                "percentages": [
                    {
                        "percentage": 25,
                        "amount": 150.00
                    }
                ]
            }
        ]
    },
    "requiresFirstHolder": true,
    "maximumSizePrintedName": 21,
    "globalWithdrawalLimitPercentage": 15,
    "modality": "MULTIPLE",
    "walletInfo": {
        "applePayAllowed": true,
        "samsungPayAllowed": true,
        "googlePayAllowed": true
    },
    "externalProductsAndBenefits": [
        {
            "type": "UNICRED_TAG",
            "name": "Unicred TAG",
            "description": "Economize tempo e viaje em segurança com a Unicred TAG. Abra cancelas de pedágios e estacionamentos sem tocar em dinheiro, tickets ou maquininhas.",
            "enabled": true
        }
    ],
    "messageId": "askjdkaj",
    "sms": true
}

**Exemplo curl:**

curl --location 'https://api.test.cartoesunicred.com.br/v1/cards/params/products/7068c094-877a-4351-8c64-4a82abf759f2' \
--header 'Authorization: eyJ...' \
--header 'Content-Type: application/json' \
--header 'Traffic-code: 136' \
--header 'X-Api-Key: Qx57PDpZDC5OAJA4ZgBSp7QPpFsBIODC14bAf3dK' \
--header 'Organization: 9184'
}'

## <a id="pf"></a>Endpoint que busca o cliente PF em cartões pelo seu identificador.
**GET:**
https://api.test.cartoesunicred.com.br/v1/cards/customers/natural-persons/{uuid}

**Headers:**
* Authorization
* **Exemplo:** eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiM **(required)**
* Traffic-Code
* **Exemplo:** 136 **(required)**
* X-Api-Key
* **Exemplo:** tvlNwSLXMx2henaVrcY8G7FzcBMGnoLJay9mbOFs **(required)**

**Path Param:**
* uuid (Uuid do customer)
* **Exemplo:** be172072-4eb0-44b9-b454-87cae598aaf8

**Retornos:**

200 (Ok)
400 (Bad Request)
401 (Unauthorized)
404 (Not Found) // Customer não encontrado
500 (Internal Server Error)

**Exemplos de retorno:**

Retorna 200 quando o customer existe:

{
  "customerUuid": "string",
  "institution": "string",
  "name": "string",
  "organizations": ["string"],
  "document": "string",
  "dateOfBirth": "2020-03-26",
  "gender": "string",
  "email": "string",
  "mobile": {
    "countryCode": "string",
    "areaCode": "string",
    "number": "string"
  }
}

**Exemplo curl:**

curl --location 'https://api.test.cartoesunicred.com.br/v1/cards/customers/natural-persons/23431a1d-5dc6-3060-9f07-f5202392b917' \
--header 'Authorization: eyJ...' \
--header 'Content-Type: application/json' \
--header 'Traffic-code: 136' \
--header 'X-Api-Key: Qx57PDpZDC5OAJA4ZgBSp7QPpFsBIODC14bAf3dK'

## <a id="pj"></a>Endpoint que busca o customer PJ em cartões pelo seu identificador.

**GET:**
https://api.test.cartoesunicred.com.br/v1/cards/customers/companies/{uuid}

**Headers:**
* Authorization
* **Exemplo:** eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI2cG9MdlIzckE2aVRBMThhbE1GeGk4b0xFN0F0SWVVZG5xcFpLdlVqYlE0In0.eyJleHAiOjE2MTM2NTk1NzksImlhdCI6MTYxMzY1OTI3OSwianRpIjoiM **(required)**
* Traffic-Code
* **Exemplo:** 136 **(required)**
* X-Api-Key
* **Exemplo:** tvlNwSLXMx2henaVrcY8G7FzcBMGnoLJay9mbOFs **(required)**

**Path Param:**
* uuid (Uuid do customer)
* **Exemplo:** be172072-4eb0-44b9-b454-87cae598aaf8

**Retornos:**
200 (Ok)
400 (Bad Request)
401 (Unauthorized)
404 (Not Found) // Customer não encontrado
500 (Internal Server Error)

**Exemplo de retorno:**

{
   "uuid":"aa93106f-2ae6-3318-9d56-17009d4bd735",
   "institution":"136",
   "name":"Unicred do Brasil",
   "fantasyName":"Confederação",
   "foundationDate":"1954-01-24",
   "email":"[e-mail]",
   "mobile":{
      "countryCode":"55",
      "areaCode":"051",
      "number":"996168793"
   },
   "document":"01408775000163"
}

**Exemplo curl:**

curl --location 'https://api.test.cartoesunicred.com.br/v1/cards/customers/companies/69ff2926-c805-380a-ab9c-7feceeef42ad' \
--header 'Authorization: eyJ...' \
--header 'Content-Type: application/json' \
--header 'Traffic-code: 136' \
--header 'X-Api-Key: Qx57PDpZDC5OAJA4ZgBSp7QPpFsBIODC14bAf3dK'