Sample code for 30+ languages & platforms
Java Requires Chilkat v11.0.0+

Amazon Pay - Create Refund

See more Amazon Pay Examples

Initiate a full or partial refund for a charge.

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.HttpResponse;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.PrivateKey;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example assumes the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Http http = new Http();

        // Implements the following CURL command:

        // curl "https://pay-api.amazon.com/:version/refunds/" \
        // -X POST
        // -H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"
        // -H "x-amz-pay-date:20201012T235046Z"
        // -H "x-amz-pay-idempotency-key:AVLo5tI10BHgEk2jEXAMPLEKEY"
        // -d '{
        //     "chargeId": "CHARGE_ID",
        //     "refundAmount": {
        //         "amount": "14.00",
        //         "currencyCode": "USD"
        //     },
        //     "softDescriptor": "Descriptor"
        // }'

        // Use the following online tool to generate HTTP code from a CURL command
        // Convert a cURL Command to HTTP Source Code

        // Use this online tool to generate code from sample JSON:
        // Generate Code to Create JSON

        // The following JSON is sent in the request body.

        // {
        //     "chargeId": "CHARGE_ID",
        //     "refundAmount": {
        //         "amount": "14.00",
        //         "currencyCode": "USD"
        //     },
        //     "softDescriptor": "Descriptor"
        // }

        JsonObject json = new JsonObject();
        json.updateString("chargeId", "CHARGE_ID");
        json.updateString("refundAmount.amount", "14.00");
        json.updateString("refundAmount.currencyCode", "USD");
        json.updateString("softDescriptor", "Descriptor");

        // Load your Amazon Pay private key.
        // There are many other ways to load private keys into the Chilkat private key object, such as from different formats,
        // or from in-memory strings or bytes.
        PrivateKey privKey = new PrivateKey();
        try {
            privKey.loadPemFile("C:/someDir/myAmazonPayPrivateKey.pem");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // Provide your Amazon Pay private key and Public Key ID
        // Use your public key ID here.  It must be the one associated with the private key.
        // Note: The SetAuthPrivateKey method was added in Chilkat v9.5.0.89
        String publicKeyId = "SANDBOX-AHEGSJCM3L2S637RBGABLAFW";
        try {
            http.setAuthPrivateKey(publicKeyId, privKey);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // Note: When the private key is provided as shown above, Chilkat will automatically add the required x-amz-pay-* headers to the HTTP request,
        // and will also sign the request.  Nothing more is needed.
        // Chilkat automatically generates and adds the following headers:
        //
        // x-amz-pay-date
        // x-amz-pay-host
        // x-amz-pay-region
        // x-amz-pay-idempotency-key
        // Authorization

        http.setAccept("application/json");

        // To use the live system, replace "sandbox" with "live" in the URL passed to HttpJson.
        // Also, make sure to use the correct region: pay-api.amazon.com, pay-api.amazon.eu, or pay-api.amazon.jp
        HttpResponse resp = new HttpResponse();
        try {
            http.httpJson("POST", "https://pay-api.amazon.eu/sandbox/v2/refunds/", json, "application/json", resp);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        StringBuilder sbResponseBody = new StringBuilder();
        resp.getBodySb(sbResponseBody);
        JsonObject jResp = new JsonObject();
        jResp.loadSb(sbResponseBody);
        jResp.setEmitCompact(false);

        // If the status code is not equal to 201, this will display error information.
        System.out.println("Response Body:");
        System.out.println(jResp.emit());

        int respStatusCode = resp.getStatusCode();
        System.out.println("Response Status Code = " + respStatusCode);
        if (respStatusCode != 201) {
            System.out.println("Failed.");
            return;
        }

        // Sample JSON response:
        // (Sample code for parsing the JSON response is shown below)

        // {
        //      "refundId": "S01-5105180-3221187-R022311",
        //      "chargeId": "S01-5105180-3221187-C056351",
        //      "refundAmount": {
        //          "amount": "14.00",
        //          "currencyCode": "USD"
        //      },
        //      "softDescriptor": "Descriptor",
        //      "creationTimestamp": "20190714T155300Z",
        //      "statusDetails": {
        //          "state": "RefundInitiated",
        //          "reasonCode": null,
        //          "reasonDescription": null,
        //          "lastUpdatedTimestamp": "20190714T155300Z"
        //      },
        //      "releaseEnvironment": "Sandbox"
        // }

        // Sample code for parsing the JSON response...
        // Use the following online tool to generate parsing code from sample JSON:
        // Generate Parsing Code from JSON

        String refundId = jResp.stringOf("refundId");
        String chargeId = jResp.stringOf("chargeId");
        String refundAmountAmount = jResp.stringOf("refundAmount.amount");
        String refundAmountCurrencyCode = jResp.stringOf("refundAmount.currencyCode");
        String softDescriptor = jResp.stringOf("softDescriptor");
        String creationTimestamp = jResp.stringOf("creationTimestamp");
        String statusDetailsState = jResp.stringOf("statusDetails.state");
        String statusDetailsReasonCode = jResp.stringOf("statusDetails.reasonCode");
        String statusDetailsReasonDescription = jResp.stringOf("statusDetails.reasonDescription");
        String statusDetailsLastUpdatedTimestamp = jResp.stringOf("statusDetails.lastUpdatedTimestamp");
        String releaseEnvironment = jResp.stringOf("releaseEnvironment");
    }
}