Refunds are not matched to a purchase

The PayFacto host does not validate the refund Amount against any original transaction. The refund amount may be lower, equal, or higher than the original purchase. Your application is responsible for enforcing any business rules around refund limits. If you need to tie a refund back to a specific transaction, consider using Refund Without Card or Refund with TUID instead.

   Prerequisites

   Request

All parameters are passed inside the Base64-encoded payload form field. Raw body format: auth-api-key=<key>&payload=<base64>. For terminal transactions (InputType=N), send CardNumber as 40 spaces and ExpirationDate as 4 spaces. The source specification does not designate individual fields as mandatory vs optional for this endpoint — treat all fields in the table below as required for a well-formed request.

   Request — Code Example

The example below uses the test endpoint and a sandbox API key. Replace credentials and base URL before going live.

# Refund — POST /v1/refund
# Step 1: Build the cleartext payload
PAYLOAD="CompanyNumber=12345\
&MerchantNumber=53400000\
&CustomerNumber=CLIENT12\
&Amount=00000010000\
&InvoiceNumber=INV000000040\
&InputType=I\
&CardType=V\
&CardNumber=4111111111111111\
&ExpirationDate=1226\
&MerchantTerminalNumber=     \
&LanguageCode=E\
&CurrencyCode=CAD\
&OperatorID=USER0001"

# Step 2: Base64-encode the payload
ENCODED=$(echo -n "$PAYLOAD" | base64)

# Step 3: Submit the request
curl -X POST "https://test.api.payfacto.cloud/v1/refund" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "auth-api-key=YOUR_TEST_API_KEY&payload=$ENCODED"

   Response

The source specification does not designate any response fields as unconditionally mandatory for this endpoint. All fields below may be returned depending on the card type, input method, and refund outcome. Always check returnCode first to determine whether the refund succeeded.

   Response — Code Example

{
  "returnCode":          "00",
  "authorizationNumber": "REFND903",
  "transactionNumber":   "000111223100",
  "referenceNumber":     "0000000040",
  "amount":              "00000010000",
  "accountType":         "C",
  "cardNumber":          "411111XXXXXX1111                       ",
  "cardType":            "V",
  "trxType":             "C",
  "trxCode":             "03",
  "trxDate":             "05152024",
  "trxTime":             "200001",
  "trxMethod":           "T@1",
  "timeStamp":           "20240515-20000100",
  "batchNumber":         "0001",
  "sequenceNumber":      "000011112228",
  "serverNumber":        "0001",
  "terminalNumber":      "00001",
  "bankTerminalNumber":  "00000001",
  "companyNumber":       "12345",
  "merchantNumber":      "53400000",
  "invoiceNumber":       "INV000000040",
  "expirationDate":      "1226",
  "languageCode":        "E",
  "operatorId":          "USER0001",
  "receiptDisp":         "APPROVED-THANK-YOU      ",
  "terminalDisp":        "APPROVED        "
}

{
  "returnCode":        "9121",
  "errorDescription":  "CARD DECLINED",
  "terminalDisp":      "DECLINED        ",
  "receiptDisp":       "DECLINED                ",
  "transactionNumber": "000111223101",
  "timeStamp":         "20240515-20000200"
}

  Error / Return Codes