secure

Refund a settled or captured transaction.

post/refund

Request

  • Base URL
    https://core.demo-paco.2c2p.com/api/2.0/Refund
  • URL
    https://core.demo-paco.2c2p.com/api/2.0/Refund/refund
  • Auth
    API key in header apiKey

Request body application/jose

officeIdstring paco-CODE required

Office ID

orderNostring required

Order No. (a.k.a Transaction Invoice No.)

productDescriptionstring

Product Description (a.k.a. PNR)

issuerApprovalCodestring

Issuer approval code that obtained from authorization

refundLinkExpiryDatetimestring date-time

Custom expiry datetime for the refund payout link. If not provided, the system uses the company-configured default.

refundNotestring

Optional note for the refund request.

Example request

{
  "apiRequest": {
    "requestMessageID": "e952828c-6d19-4a08-92e4-1bc47e1945a2",
    "requestDateTime": "2023-08-29T09:12:34.001Z",
    "language": "en-US"
  },
  "orderNo": "684105191128073630",
  "productDescription": "URRT55",
  "issuerApprovalCode": "657300",
  "originalRefundAmount": {
    "amountText": "000000999950",
    "currencyCode": "THB",
    "decimalPlaces": 2,
    "amount": 9999.5
  },
  "refundAmount": {
    "amountText": "000000999950",
    "currencyCode": "THB",
    "decimalPlaces": 2,
    "amount": 9999.5
  },
  "refundItems": [
    {
      "purchaseItemPriceBase": {
        "amountText": "000000999950",
        "currencyCode": "THB",
        "decimalPlaces": 2,
        "amount": 9999.5
      },
      "purchaseItemPriceQuote": {
        "amountText": "000000999950",
        "currencyCode": "THB",
        "decimalPlaces": 2,
        "amount": 9999.5
      }
    }
  ],
  "refundToBankAccount": {
    "clientEmail": "John@2c2p.com",
    "accountName": "John Walker",
    "accountNumber": "0043966810385"
  },
  "refundNotificationURLs": {
    "confirmationURL": "http://.../ConfirmationURL.aspx",
    "failedURL": "http://.../ErrorURL.aspx",
    "cancellationURL": "http://.../CancellationURL.aspx"
  },
  "localMakerChecker": {
    "maker": {
      "username": "John",
      "email": "John@2c2p.com"
    },
    "checker": {
      "username": "John",
      "email": "John@2c2p.com"
    }
  },
  "pspMakerChecker": {
    "maker": {
      "username": "John",
      "email": "John@2c2p.com"
    },
    "checker": {
      "username": "John",
      "email": "John@2c2p.com"
    }
  },
  "customFieldList": [
    {
      "fieldName": "ExternalID5",
      "fieldValue": "AMADEUS"
    }
  ]
}

Response

Result of refund transaction that pass local approval step and go through PSP

Changes

No recorded changes to this operation across all 1 revision of this API.