Updates for July, 2024
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 aPENDING
/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.