Bandeiras de Cartão
/publics/payments/card-flags
Retorna expressões regulares para validação de bandeiras de cartão de crédito
Descrição
Retorna um mapa de expressões regulares usado para identificar bandeiras de cartão.
A rota é pública e utiliza cache para otimizar o retorno das regras de identificação de bandeira.
Exemplo de Requisição
1curl --request GET \2 --url 'https://sua-loja-uappi.com.br/api/v3/publics/payments/card-flags'✅ Resposta de Sucesso
1{2 "status": true,3 "data": {4 "master": "/^5[1-5]{1}[0-9]{10}|^2((2(21[0-9]{2}|2[2-9][0-9]{2}|[3-9][0-9]{3})|[3-6][0-9]{4})|7([0-1][0-9]{4}|20[0-9]{2}))$/",5 "visa": "/^4[0-9]{12,15}/",6 "hiper": "/^(637095\\d{10}(\\d{3})?)$/",7 "amex": "/^3[47][0-9]{13}/",8 "hipercard": "/^(((606282)\\d{0,10})|((3841)\\d{0,15}))/",9 "americanexpress": "/^3[47]\\d{13}$/",10 "jcb": "/^35[0-9]{14}/",11 "aura": "/^50(?!4175|6699|67[0-7][0-8]|9)[0-9]{10,17}/",12 "banescard": "/^636117/",13 "cabal": "/(60420[1-9]|6042[1-9][0-9]|6043[0-9]{2}|604400)/",14 "diners": "/^3(?:0[0-5]|[68][0-3]|[68][5-9])[0-9]{11}$/",15 "discover": "/^6(?:011|5[0-9]{2}|4[4-9][0-9]|22[1-9]|2[3-6][0-9]|27[01]|2720)[0-9]{10}/",16 "sorocred": "/^627892|^636414/",17 "unionpay": "/^(62|88)[0-9]{14}$/",18 "credz": "/^((636760\\d{10}(\\d{3})?)|(606282\\d{10}(\\d{3})?)|(639388\\d{10}(\\d{3})?)|(504175\\d{10}(\\d{3})?)|(603136\\d{10}(\\d{3})?))$/",19 "elo": "<regex dinâmica gerada a partir da lista de BINs Elo>"20 }21}Condições de Pagamento
/publics/payments/conditions
Calcula condições de pagamento e parcelamento disponíveis para uma lista de itens
Descrição
Calcula, por item informado, cenários de pagamento à vista e parcelado com base nas opções enviadas e nas regras ativas da integração.
A rota é pública e valida o payload antes do processamento, exigindo a estrutura de items com referência e valor. O retorno traz os valores consolidados por item (subtotal, desconto à vista e composições de parcela), sem executar captura/cancelamento e sem alterar o estado de pedidos.
Parâmetros
Cabeçalhos
| Header | Valor | Descrição |
|---|---|---|
Content-Type | application/json | Tipo de conteúdo |
Parâmetros do Corpo
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
cashDiscountPaymentOptionId | integer | Não | ID da opção de pagamento com desconto à vista |
installmentPaymentOptionId | integer | Não | ID da opção de pagamento parcelado |
items | array | Sim | Lista de itens para cálculo |
items.*.reference | string | Sim | Referência do item, até 100 caracteres |
items.*.value | numeric | Sim | Valor do item |
Exemplo de Requisição
1curl --request POST \2 --url '{{MAIN_URL}}/publics/payments/conditions' \3 --header 'Content-Type: application/json' \4 --data '{5 "cashDiscountPaymentOptionId": 1,6 "installmentPaymentOptionId": 1,7 "items": [8 {9 "reference": "1",10 "value": 123.4511 }12 ]13 }'✅ Resposta de Sucesso
1{2 "status": true,3 "data": {4 "1": {5 "reference": "1",6 "value": 123.45,7 "cashDiscount": {8 "discountPercentage": 0,9 "discountValue": 0,10 "valueWithDiscount": 123.4511 },12 "installments": [13 {14 "installment": 1,15 "installmentValue": 123.45,16 "totalValue": 123.45,17 "fee": 0,18 "feeTotalValue": 019 },20 {21 "installment": 2,22 "installmentValue": 61.73,23 "totalValue": 123.46,24 "fee": 0,25 "feeTotalValue": 026 }27 ],28 "subtotalValue": 123.4529 }30 }31}⚠️ Possíveis erros:
| Código Interno | Código HTTP | Descrição |
|---|---|---|
| UAPPI_INTEGRATION_PAYMENT_OPTION_NOT_FOUND | 404 |