Skip to main content
There have been some updates on Payments object and transaction requests. Please check the updates below.
  • Wallet Cryptogram
  • Simplified mode for refunds

​
Wallet Cryptogram

We’ve added a new field to the Payment method object while creating the Payment called cryptogram. It is a field that lets you use your Apple/Google pay native integration and make payments directly vía API. You will also find the fingerprint in the payment response when a transaction is made. Example 
"payment_method": {
    "detail": {
      "wallet": {
        "cryptogram": "{\"data\":\"e2Nz1Y2ADnyZ1JQsvYEhv0n24DEOqRN8DRqeSfGCtz5WyT5YNLb\\/fFaShhsqzIa5PuO0QM3zwty6tCXX4Vb3\\/s5oF0pkC1MGhacojT7kRkwfoo01hH75ucmnxZ8BeyJ1ryh86cQEPKYcdIzpq0y6p1f\\/hOt44Wi6plGRjyMKk+WuAOYqS4i\\/Vhsl6KPwcUEbwI47kWVb3Xy9L6sU0kClxFj3o+w1SDiqQ0c3H0Yf4Fg2AnzVvK+LvZMCpcy5U60HhkwtvtKqYNB4nINpE+iGv\\/xOVxVE\\/vKtgLDFKn0zC24HrRMpYOY2U7F0m4n3W1+6iA5VUF+jmBqVUtv6Q\\/2lRqkuoZDOMq2yIPyM0HGc0VGeFpLpd6dGYVerE0KRHot\\/ERT+S0qaYhtd5Ob1EtLnolmfqa49fP09LYSg+mpnN9MG\",\"signature\":\"MIAGCSqGSIb3DQEHAqCAMIACAQExDTALBglghkgBZQMEAgEwgAYJKoZIhvcNAQcBAACggDCCA+MwggOIoAMCAQICCBZjTIsOMFcXMAoGCCqGSM49BAMCMHoxLjAsBgNVBAMMJUFwcGxlIEFwcGxpY2F0aW9uIEludGVncmF0aW9uIENBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzAeFw0yNDA0MjkxNzQ3MjdaFw0yOTA0MjgxNzQ3MjZaMF8xJTAjBgNVBAMMHGVjYy1zbXAtYnJva2VyLXNpZ25fVUM0LVBST0QxFDASBgNVBAsMC2lPUyBTeXN0ZW1zMRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABMIVd+3r1seyIY9o3XCQoSGNx7C9bywoPYRgldlK9KVBG4NCDtgR80B+gzMfHFTD9+syINa61dTv9JKJiT58DxOjggIRMIICDTAMBgNVHRMBAf8EAjAAMB8GA1UdIwQYMBaAFCPyScRPk+TvJ+bE9ihsP6K7\\/S5LMEUGCCsGAQUFBwEBBDkwNzA1BggrBgEFBQcwAYYpaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZWFpY2EzMDIwggEdBgNVHSAEggEUMIIBEDCCAQwGCSqGSIb3Y2QFATCB\\/jCBwwYIKwYBBQUHAgIwgbYMgbNSZWxpYW5jZSBvbiB0aGlzIGNlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBhc3N1bWVzIGFjY2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFyZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRlIHBvbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjdGljZSBzdGF0ZW1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2VydGlmaWNhdGVhdXRob3JpdHkvMDQGA1UdHwQtMCswKaAnoCWGI2h0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlYWljYTMuY3JsMB0GA1UdDgQWBBSUV9tv1XSBhomJdi9+V4UH55tYJDAOBgNVHQ8BAf8EBAMCB4AwDwYJKoZIhvdjZAYdBAIFADAKBggqhkjOPQQDAgNJADBGAiEAxvAjyyYUuzA4iKFimD4ak\\/EFb1D6eM25ukyiQcwU4l4CIQC+PNDf0WJH9klEdTgOnUTCKKEIkKOh3HJLi0y4iJgYvDCCAu4wggJ1oAMCAQICCEltL786mNqXMAoGCCqGSM49BAMCMGcxGzAZBgNVBAMMEkFwcGxlIFJvb3QgQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE0MDUwNjIzNDYzMFoXDTI5MDUwNjIzNDYzMFowejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8BcRhBnXZIXVGl4lgQd26ICi7957rk3gjfxLk+EzVtVmWzWuItCXdg0iTnu6CP12F86Iy3a7ZnC+yOgphP9URaOB9zCB9DBGBggrBgEFBQcBAQQ6MDgwNgYIKwYBBQUHMAGGKmh0dHA6Ly9vY3NwLmFwcGxlLmNvbS9vY3NwMDQtYXBwbGVyb290Y2FnMzAdBgNVHQ4EFgQUI\\/JJxE+T5O8n5sT2KGw\\/orv9LkswDwYDVR0TAQH\\/BAUwAwEB\\/zAfBgNVHSMEGDAWgBS7sN6hWDOImqSKmd6+veuv2sskqzA3BgNVHR8EMDAuMCygKqAohiZodHRwOi8vY3JsLmFwcGxlLmNvbS9hcHBsZXJvb3RjYWczLmNybDAOBgNVHQ8BAf8EBAMCAQYwEAYKKoZIhvdjZAYCDgQCBQAwCgYIKoZIzj0EAwIDZwAwZAIwOs9yg1EWmbGG+zXDVspiv\\/QX7dkPdU2ijr7xnIFeQreJ+Jj3m1mfmNVBDY+d6cL+AjAyLdVEIbCjBXdsXfM4O5Bn\\/Rd8LCFtlk\\/GcmmCEm9U+Hp9G5nLmwmJIWEGmQ8Jkh0AADGCAYcwggGDAgEBMIGGMHoxLjAsBgNVBAMMJUFwcGxlIEFwcGxpY2F0aW9uIEludGVncmF0aW9uIENBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUwIIFmNMiw4wVxcwCwYJYIZIAWUDBAIBoIGTMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTI0MDYyMDIyMjk0OVowKAYJKoZIhvcNAQk0MRswGTALBglghkgBZQMEAgGhCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIIDfMdZ2yfgvpWxt7PNOnUS27A0WGUQN0SnWz40HH\\/fGMAoGCCqGSM49BAMCBEYwRAIgWZqIeQGG+vU+DKnaq5FlbI\\/hvSc0CB4P9KjD+RGUDm0CIGe7\\/84VmiUaMpuiu4fngAYz7nuC3arZV5jy0NVPzvRZAAAAAAAA\",\"header\":{\"publicKeyHash\":\"YK8kdoBXLGqBQKBtCZOl0DQTUHOWidRCxgOgf\\/1gBMM=\",\"ephemeralPublicKey\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEzvJDjQ1bAF6ICjz9ThNDw9hz+1iuiTfy2qypHwKX3kmKOWQ2fjDl4d5SLHc6ahKCw92qh2sg1DLYvnaWc2h9Og==\",\"transactionId\":\"a760ee6c5ed60231976ea3393987f223660b0b70c3419558305d2fcbb379adf3\"},\"version\":\"EC_v1\"}"
      }
    },
    "type": "APPLE_PAY"
  },

​
Simplified mode for refunds

Yuno allows merchants to retry capture and refund transactions that received an error or declined response from the provider by adding a field to the transaction request. This feature is designed to enhance transaction success rates and improve user experience. By setting the simplified_mode field to true in capture and refund requests, the system will:
  • Return a SUCCEEDED status for capture transactions so you dont have to worry about the retry scheme and Yuno will automatically retry failed or pending transactions up to five times within a 24-hour period.
  • Return the DECLINED status for the transaction, leaving the payment in a PENDING/RETRY_IN_PROCESS status, and Yuno will automatically retry failed or pending transactions up to five times within a 24-hour period.
Example 
{
  "simplified_mode": true,
  "reason": "REQUESTED_BY_CUSTOMER",
  "merchant_reference": "AA01"
}
For more information, please refer to the Transaction retries section in Guides.

​
Taxes

For a better handling of the taxes information for every payment, in Yuno we have added a Taxes array of objects inside the additional_data. order struct so the merchants can send more than one Tax line for each case. If you are sending the Tax object outside the additional_data struct, don’t worry, we are going to keep supporting the object, but for a better management of taxes we recommend to start using the new array of objects available instead. For more information on how it works, please refer to the Payment amount details on the Guides section.