...
Dia D – dia do consentimento.
Eixo X - representa o tempo em meses.
Eixo em Y – representa o cenários que são produtos e suas vigências. Ex.: conta cartão cancelada/encerrada a 13 meses • O encontro dos eixos representa o status da API Recursos naquele tempo para aquele produto.
Comportamento da API de Cartão de Crédito com relação a API de Recursos
Visão da API de Recursos (Resources) para o Tipo de Cartão de Crédito (Credit-Cards-Accounts)
O identificador único resourceId de cada recurso do tipo CREDIT_CARD_ACCOUNT presente na lista devolvida pela API, corresponde ao identificador único creditCardAccountId utilizado pela API de Cartão de Crédito (Credit-Cards-Accounts). Por exemplo:
| Bloco de código |
|---|
{
“data”: [
{
“resourceId”: “12345678990”,
“type”: “ CREDIT_CARD_ACCOUNT “,
“status”: “AVAILABLE”
}
]
} |
Exemplo de utilização do resourceId em uma chamada a API de Cartão de Crédito (Credit-Cards-Accounts):
credit-cards-accounts/v1/accounts/12345678990
Cartões (ex. virtual / adicional / físico) bloqueados temporariamente não impactam o status da conta cartão associada ao consentimento.
Regras para o retorno das API Cartão de Crédito de acordo com o status do Recurso (PENDING_AUTHORISATION, AVAILABLE, UNAVAILABLE e TEMPORARILY_UNAVAILABLE) e a transição entre status
...
Cenário | Status do recurso na detentora | API Recursos (.../resources/v1/resources) | API de listagem de Produto (/accounts)¹ | APIs de Identificação da Conta (/accounts/{creditCardAccountId}² | Code |
|---|---|---|---|---|---|
Sem consentimento | - | 401 unauthorized | 401 unauthorized | 401 unauthorized | |
Com consentimento não autorizado | - | 401 unauthorized | 401 unauthorized | 401 unauthorized | |
Com consentimento autorizado (pendente múltipla alçada) | - | 200 - Retorna recurso com status PENDING_ AUTHORISATION | 200 Não retorna | 403 forbidden | |
Com consentimento autorizado (aprovado múltipla alçada) | OK | 200 - Retorna o recurso com status AVAILABLE | 200 retorna o recurso na lista | 200 retorna dados para o recurso | |
Com consentimento autorizado (aprovado múltipla alçada) | Bloqueio Temporário | 200 - Retorna o recurso com status TEMPORARY_ UNAVAILABLE | 200 Não retorna na lista o recurso “bloqueado” | 403 forbidden | |
Com consentimento autorizado (aprovado múltipla alçada) | Cancelado/Encerrado | 200 - Retorna o recurso como status AVAILABLE | 200 retorna o recurso na lista | 200 retorna o recurso na lista | |
Com consentimento autorizado (aprovado múltipla alçada) | Cancelado/Encerrado a mais de 12 meses (recurso nunca compartilhado na vigência do consentimento) | 200 – Não retorna o recurso | 200 – Não retorna o recurso | 403 forbidden | |
Com consentimento autorizado (aprovado múltipla alçada) | Cancelado/Encerrado a mais de 12 meses (recurso já compartilhado na vigência do consentimento) | 200 - Retorna o recurso como status UNAVAILABLE | 200 – Não retorna o recurso | 403 forbidden | |
Com consentimento autorizado (recusado múltipla alçada) | - | 200 - Retorna recurso com status UNAVAILABLE | 200 - Não retorna recurso recusado na lista | 403 forbidden | |
Com consentimento autorizado (conta inexistente) | - | 200 – Não retorna o recurso | 200 – Não retorna o recurso | 403 forbidden | RESOURCE_FORBIDDEN |
Com consentimento revogado ou expirado¹ | - | 401 unauthorized | 401 unauthorized | 401 unauthorized |
...
/accounts/{creditCardAccountId}/bills;
/accounts/{creditCardAccountId}/{billId}/transactions;
/accounts/{creditCardAccountId}/transactions;
/accounts/{creditCardAccountId}/transactions-current.
Orientações para listagem do paymentMethod:
Para o retorno listagem dos cartões (campo paymentMethod) do endpoint de Identificação de Cartão (GET /accounts/{creditCardAccountId}), os cartões físicos e virtuais ativos (de titular, dependentes ou adicionais) são de compartilhamento obrigatório através desta listagem. Caso o cartão já tenha sido excluído, o seu envio torna-se opcional.
Obs: Ainda que o cartão não conste nesta listagem, as transações relacionadas devem ser listadas com o número de identificação do cartão (campo identificationNumber) correspondente.