The Refund EHN is received when a refund has either been completed or failed. Only applicable to refunds for mobile payments.

Data Fields

In addition to the Common Fields, you will receive the following information:

PropertyTypeDescription
ORDER_ID
required
guidPaynova's unique identifier for the order to which the payment belongs.
ORDER_NUMBER
required
stringYour order/PO number for this order.
REFUND_STATUS
required
stringThe status of the refund.

Possible values:



> DECLINED
The refund was declined.


> PENDING
The refund is in a pending state.

> COMPLETED
The refund has been completed and no further action is required.
REFUND_STATUS_REASON
required
stringA finer-grained status code possibly providing more information as to the value of REFUND_STATUS.

Possible values:

> NONE
No additional reason information is available.

> BANK_COMMUNICATION_ERROR
There was an error communicating with the bank.

> DECLINED_BY_PROCESSOR
The transaction was declined by the bank or processor.
AMOUNT
required
decimalThe amount of the transaction. Two decimal points, decimal point as separator.

Example: 1234.56
CURRENCY_CODE
required
string(3)The three-letter currency code.

Example: "SEK"
TRANSACTION_ID
required
intThe transaction ID.

Constraints:
> Length=18

Example: "123123123123123123"
ACQUIRER_ID
required
intPaynova's ID for the acquirer of the transaction.

Constraints:
> Length=4
ACQUIRER_REFERENCE_ID
required
stringThe reference id that the bank uses to refer to this transaction.

Example - REFUND

Total-Route-Time: 0
Content-Length: 972
Connect-Time: 2
Connection: close
Content-Type: application/x-www-form-urlencoded
Pn-Digest: 57E0AD4EF608761FEC10073274EF54BC33C12386
Via: 1.1 vegur
X-Request-Id: dced1302-8923-41c2-a62c-4315d70071f7
Host: requestbin.com
ORDER_ID: 3ec05393-4598-484e-8666-a37f00cb0499
ORDER_NUMBER: API-99C91D50-20140806141826
ACQUIRER_REFERENCE_ID: 500113544
REFUND_STATUS: COMPLETED
AMOUNT: 100.00
ACQUIRER_ID: 1010
DIGEST: 514ECFE34864E8F717CE016F1505D94FBF8B5813
DELIVERY_TIMESTAMP: 2016-11-06 12:22:19Z
TRANSACTION_ID: 201611061421475374
EVENT_TYPE: REFUND
REFUND_STATUS_REASON: NONE
EVENT_TIMESTAMP: 2016-11-06 12:22:19Z
CURRENCY_CODE: SEK
MERCHANT_ID: 4999
ACQUIRER_ID=1010&ACQUIRER_REFERENCE_ID=500113544&AMOUNT=100.00&CURRENCY_CODE=SEK&DELIVERY_TIMESTAMP=2014-08-06+12%3a22%3a19Z&DIGEST=514ECFE34864E8F717CE016F1505D94FBF8B5813&EVENT_TIMESTAMP=2016-11-06+12%3a22%3a19Z&EVENT_TYPE=REFUND&MERCHANT_ID=4999&ORDER_ID=3ec05393-4598-484e-8666-a37f00cb0499&ORDER_NUMBER=API-99C91D50-20161106141826&PAYMENT_METHOD_ID=1&REFUND_STATUS=COMPLETED&REFUND_STATUS_REASON=NONE&SESSION_ID=04156f48-e6d4-45b1-8f62-a37f00cb17c2&TRANSACTION_ID=201611061421475374