Atualizações para fevereiro de 2024

Houve algumas atualizações no objeto de pagamentos e nas mensagens de resposta. Confira as atualizações abaixo.

Histórico de transações
Valor da gorjeta
Mensagem de resposta de transação inválida
Campo da vizinhança

Histórico de transações

Adicionamos um novo objeto ao Objeto de pagamento resposta chamada transactions_history. É uma matriz de objetos que representa a lista das transações que fazem parte de um pagamento. O valor de transações vai depender de quantos provedores você configurou na sua rota de método de pagamento.

Valor da gorjeta

Adicionamos um novo campo ao campo Objeto de pagamento dentro do additional_data.order estrutura chamada tip_amount. Representa o valor da gorjeta do pedido. Este campo é meramente informativo, pois o valor da gorjeta já está incluído no valor final da transação e não é adicionado separadamente.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <Your idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <Your private-secret-key>' \
     --header 'public-api-key: <Your public-api-key>' \
     --data '
{
    "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "CO",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "COP",
        "value": 5000.00
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "additional_data": {
          "order": {
              "tip_amount": 50.00
          }
      },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "vaulted_token": "eb8caa17-6407-457b-960e-125d8d7a90c1",
        "detail": {
           "card": {
               "stored_credentials":{
                  "reason":"CARD_ON_FILE",
                  "usage": "USED"
              }
           }
        }
    }
}
'

Para obter mais informações, consulte a documentação com os detalhes do valor do pagamento.

Mensagem de resposta de transação inválida

Adicionamos novas informações ao response_message da chamada da API quando uma transação de captura está sendo tentada e já existe uma em andamento.

{  
    "code": "INVALID_STATUS",  
    "messages": [  
        "Invalid transaction status. Transaction already in progress"  
    ]  
}

Bairro

Adicionamos um novo campo ao campo Objeto cliente dentro do shipping_addrese billing_address chamado neighborhoodRepresenta a vizinhança da linha de endereço do cliente (MÁX. 255; MÍN. 3).