cards têm o objetivo de prover os dados de cartões e tokens criados na Malga, bem como dos clientes associados, facilitando a análise das informações nestes serviços. Não são expostos dados sensíveis nestas consultas, tais como CVV e documentos dos clientes.
No grupo Cards disponibilizamos as seguintes consultas:
allCards (deprecated) | Retorna todos os cartões e tokens. Depreciada — será descontinuada em 2027. Utilize cards. |
cards | Retorna os cartões a partir do novo índice card, com os tokens e as solicitações de transação aninhados, além de novos campos e filtros. |
card | Retorna um único cartão pelo id a partir do novo índice card. |
allCards
Retorna todos os cartões.| QUERY : OBJETO DE RETORNO | allCards: CardsConnection |
| ARGUMENTO : TIPO | DESCRIÇÃO |
| first: Int | Retorna os primeiros n elementos da lista. O padrão é 100 |
| after: String | Retorna os elementos da lista que vêm após o ID global especificado. |
| startDate: Datetime | startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd HH:mm:ss.SSSS) |
| endDate: Datetime | endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd HH:mm:ss.SSSS) |
| cardId: String | ID do cartão |
| cardStatus: String | Status do cartão |
| brand: String | Bandeira do cartão |
| customerId: String | ID do cliente vinculado ao cartão |
| holderName: String | Nome do portador do cartão |
cards
Retorna os cartões a partir do novo índicecard. Mantém paridade de argumentos com allCards (o filtro de identificador passa a se chamar id). Adiciona novos campos e filtros, incluindo consultas nos objetos aninhados tokens e transactionRequests.
| QUERY : OBJETO DE RETORNO | cards: CardV2Connection |
| ARGUMENTO : TIPO | DESCRIÇÃO |
| first: Int | Retorna os primeiros n elementos da lista. O padrão é 100 |
| after: String | Retorna os elementos da lista que vêm após o cursor especificado. |
| id: [String] | Filtra por um ou mais IDs de cartão |
| cardStatus: [String] | Status do cartão |
| tokenStatus: [String] | Status do token (consulta no objeto aninhado tokens) |
| customerId: String | ID do cliente vinculado ao cartão |
| brand: String | Bandeira do cartão |
| holderName: String | Nome do portador do cartão |
| sellerId: String | ID do recebedor (seller) vinculado ao cartão |
| merchantId: String | ID do merchant vinculado ao cartão |
| fingerprint: String | Fingerprint do cartão |
| tokenFingerprint: String | Fingerprint do token (consulta no objeto aninhado tokens) |
| tokenProviderType: [String] | Tipo de provider do token (consulta no objeto aninhado tokens) |
| providerType: [String] | Tipo de provider (consulta no objeto aninhado transactionRequests) |
| expirationMonth: String | Mês de expiração do cartão |
| expirationYear: String | Ano de expiração do cartão |
| startDate: Date | Início do intervalo de criação (created_at), no formato yyyy-MM-dd |
| endDate: Date | Fim do intervalo de criação (created_at), no formato yyyy-MM-dd |
| updatedStartDate: Date | Início do intervalo de atualização (updated_at), no formato yyyy-MM-dd |
| updatedEndDate: Date | Fim do intervalo de atualização (updated_at), no formato yyyy-MM-dd |
id, clientId, customerId, status, brand, holderName, createdAt, updatedAt, expirationMonth, expirationYear, merchants, sellers, fingerprint), o objeto de retorno traz os objetos aninhados tokens e transactionRequests.
card
Retorna um único cartão peloid a partir do novo índice card.
| QUERY : OBJETO DE RETORNO | card: CardV2Connection |
| ARGUMENTO : TIPO | DESCRIÇÃO |
| id: String | ID do cartão a ser consultado |