Refund API

Humm provides an API to programmatically process refunds or adjustments to an humm purchase.

Humm Endpoints

Humm Environment	URL
Production Endpoint	https://buyerapi.shophumm.co.nz/api/ExternalRefund/v1/processrefund
Sandbox Endpoint	https://integration-buyerapi.shophumm.co.nz/api/ExternalRefund/v1/processrefund

Request

Headers

Key	Value
Content-Type	application/json

Body

{
    "x_merchant_number": "30199250",
    "x_purchase_number": "52004168",
    "x_amount": "10.00",
    "x_reason": "Test refund",
    "signature": "e39ae5f3233f561162836989e050c1b61ba9e3d5eb3d64d4b3701e95fb5850a1"
}

See Signature Generation for information on how to generate the HMAC Signature.

Response

HTTP Status	Reason Code	Reason Description
204	none	Success
400	MERR0001	API Key Not found
400	MERR0003	Refund Failed
400	MERR0004	Invalid Request
401	none	Failed Signature Check

Example

The following curl command will allow you to test the refunds API. You will need to substitute your x_merchant_number, x_purchase_number and signature

curl \
--header "Content-Type:application/json" \
--request POST \
--data '{
    "x_merchant_number": "30199250",
    "x_purchase_number": "52000152",  
    "x_amount": 45.00,
    "x_reason": "test",
    "signature": "a5fc92ddd2326c6099bd0f43bbe75afb54004a6ba68f354cc2b40328341d8ee2"
}' \    
https://integration-buyerapi.shophumm.co.nz/api/ExternalRefund/v1/processrefund