Sorry, you need to enable JavaScript to visit this website.

6 Voucher Refund By VoucherCode

Action

Using your clientID and clientSecret (which you obtained when you created an application), you will make a Post request using the endpoint and values below to refund voucher using voucher code.

Method POST
Endpoint https://b2b-api.nedbank.co.za/apimarket/b2b-sb/cashout/v1/vouchers/<VoucherCode>/refunds
Request
Headers
Header Value Description
x-ibm-client-id <YOUR CLIENT ID> The client ID you received when creating the app on the portal.
x-ibm-client-secret <YOUR CLIENT SECRET> The client secret you received when creating the app on the portal.
x-idempotency-key <RANDOM INTEGER> Random integer. Must be unique for every call.
x-jws-signature <RANDOM INTEGER> Replace with random value.
x-fapi-financial-id OB/2017/001 Financial ID.
x-fapi-customer-ip-address 101.12.212.99 Customer IP address.
x-fapi-interaction-id <RANDOM GUID> Replace with random value.
Content-Type application/json The data type being sent to the endpoint.
Body JSON 
                                
{
    "Data": {
        "Initiation": {
            "InstructionIdentification": "REPLACE WITH RANDOM UNIQUE STRING",
            "InstructedAmount": {
                "Amount": "50.00",
                "Currency": "ZAR"
            },
            "CreditorAccount": {
                "SchemeName": "recipient",
                "Identification": "0710000000",
                "Name": "MyRefOnceOffQATrx",
                "SecondaryIdentification": "1"
            }
        },
        "ExpirationDateTime": "2024-04-17T17:31:51.477Z"
    },
    "Risk": {
        "RequestorId": "0710000000"
    }
}
Response JSON 
                            
{
  "Data": {
    "RequestorId": "0710000000",
    "Voucher": {
      "Voucher": {
        "Code": "0393330139",
        "Status": "REFUNDED",
        "Amount": {
          "Amount": "50.00",
          "Currency": "ZAR"
        },
        "Redeem": {
          "Redeemable": false,
          "Redeemed": false,
          "RedeemedAt": ""
        },
        "Refund": {
          "Refunded": true,
          "RefundedOn": "2024-05-02T00:00:00"
        }
      },
      "PaymentReferenceNumber": "489167310433"
    },
    "PaymentReferenceNumber": "489167310433",
    "RefundedOn": "2023-04-04T00:00:00",
    "Recipient": {
      "Destination": "0710000000"
    }
  },
  "Links": {
    "Self": "https://api.nedbank.co.za/apimarket/sandbox/cashout/v1/vouchers/2574161325/refunds"
  },
  "Meta": {}
}
Prev step
Next step