2013

RefundTransaction API Operation
RefundTransaction Response Message
13
188 February 01, 2013 Name-Value Pair API Developer Guide
RefundInfoType Fields
TOTALREFUNDEDAMT Total amount refunded so far from the original purchase. Say, for example, a buyer
makes $100 purchase, the buyer was refunded $20 a week ago and is refunded $30 in
this transaction. The gross refund amount is $30 (in this transaction). The total
refunded amount is $50.
Character length and limitations: Value is a positive number which cannot exceed
$10,000 USD in any currency. It includes no currency symbol. It must have 2 decimal
places, the decimal separator must be a period (.), and the optional thousands
separator must be a comma (,).
This field is available since version 67.0.
CURRENCYCODE Currency code.
Character length and limitations: 3 single-byte characters
REFUNDINFO Contains refund payment status information.
This field is available since version 84.0.
MSGSUBID (Optional) A message ID used for idempotence to uniquely identify a message. This
ID can later be used to request the latest results for a previous request without
generating a new request. Examples of this include requests due to timeouts or errors
during the original request.
Character length and limitations: string of up to 38 single-byte characters.
This field is available since version 92.0.
Field Description
REFUNDSTATUS ns:PaymentStatusCodeType
Status of the refund. It is one of the following values:
 instant
 delayed
This field is available since version 84.0.
PENDINGREASON Reason that the refund payment status is delayed. It is one of the following values:
 none – The refund status is instant.
 echeck – The refund status is delayed.
 regulatoryreview – The payment is pending while we make sure it meets
regulatory requirements. You will be contacted again in 24-72 hours with the
outcome of the review.
This field is available since version 84.0.
Field Description