Unreferenced Refund

An overview of the Unreferenced Refund request message for Android.

• Overview
• Unreferenced Refund request
• Unreferenced Refund response
• Get Support

Overview

👉 The Unreferenced Refund request allows you to process a refund without a need of prior transaction or an existing order.

The client app must implement a mechanism to send messages using Android intents and URI calls and to receive the result in a custom URI callback.

• Unreferenced Refund request originating from the client app to initiate a request for an Unreferenced Refund transaction.
• Unreferenced Refund response originating from the ‘Viva.com Terminal’ application to return the result of an Unreferenced Refund transaction.

Unreferenced Refund request

For a typical Unreferenced Refund request, the client app must provide the following information:

[*] These parameters are only applicable in Greece.

The above information elements must create a URI call, i.e.

func createUnreferencedRefundRequest(refundAmount: Decimal?) -> String {
    // construct cancel action url
    var actionURL = Constants.cancelUrlString // vivapayclient://pay/v1?callback=interapp-callback&appId=com.vivawallet.InterAppDemo&action=unreferenced_refund

    if let amount = refundAmount {
        actionURL += "&amount=\(((amount * 100) as NSDecimalNumber).intValue)" // The amount in cents without any decimal digits.
    }

    let showReceipt = UserDefaults.standard.value(forKey: "show_receipt") as? Bool ?? true
    actionURL += "&show_receipt=\(showReceipt)"

    let showResult = UserDefaults.standard.value(forKey: "show_transaction_result") as? Bool ?? true
    actionURL += "&show_transaction_result=\(showResult)"

    return actionURL
}
    //USE LIKE THIS 
        let UnreferencedRefundRequestStringURL: String = createUnreferencedRefundRequest(refundAmount: 5, reference: "123456789") 
        (UIApplication.shared.delegate as? AppDelegate)?.performInterAppRequest(request: UnreferencedRefundRequestStringURL)

The above information elements must create a URI call. i.e.

Request example

Request sample:vivapayclient://pay/v1?callback=interapp-callback&appId=com.vivawallet.InterAppDemo&action=unreferenced_refund&amount=600&show_receipt=false

Request sample for merchants registered in Greece(including AADE parameters):vivapayclient://pay/v1?callback=interapp-callback&appId=com.vivawallet.InterAppDemo&action=unreferenced_refund&amount=600&show_receipt=false&aadeProviderId=999&aadeProviderSignatureData=AD33729F4ED749928AAFA00B90EE4EA91551BAC1;;20231204080313;1051;10000;2400;12400;POS_1&aadeProviderSignature=o0094r3Yk3KTqASLkW3evlDsnIg/ZAdUUf6UCXDtjqpI/dquzAT4WNX3yzS/GLciVNbT75H4pj8hLOV0EpHtzw==

Unreferenced Refund response

After executing an Unreferenced Refund transaction, the ‘Viva.com Terminal’ application responds with an Unreferenced Refund response result to indicate if the refund has been approved or not.

The result is received as a URI in the callback activity.

The table below summarises the contents of an approved response:

Examples

A Cancel/Refund response result for an approved transaction looks as follows:

A Cancel/Refund response result for an approved transaction using AADE parameters looks as follows looks as follows:

It is expected that certain transactions will fail for various reasons. A Cancel response result for a failed transaction looks as follows:

The structure of the message is the same as in the case of an approved transaction.

Get Support

If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!