Payment Failures

🔍 Overview

If the guest has not paid and the payment request has expired, or customer's card declined, or incorrect booking information was submitted — the possible options are shared here.

You can either resend the payment request to the guest or cancel the request entirely using a simple API. This ensures smooth handling of booking exceptions.

🧭 Step-by-Step Workflow

The PMS or booking system identifies a failed or incomplete payment:

Either from a webhook notification (paymentEvent with status Expired or Declined)

Or by calling /getPaymentStatus API and noticing no or partial payment

The PMS or booking system triggers
POST /takePaymentAction API with these parameters:

bookingRefNum: Internal booking ID of the hotel

fikafiRefNum: Unique reference ID of Fikäfi

action = "resend" or "cancel"

Fikäfi performs the action:

resend: Sends payment request again to the guest

cancel: Marks payment as cancelled and stops further actions

Returns status of the performed action.

🎯 Available Actions

Action	Description
resend	Resend the payment request to the guest
cancel	Cancel the payment request

📤 Sample Request

POST /takePaymentAction?bookingRefNum=BKG123&fikafiRefNum=FIK7890&action=resend

📤 Sample Response

{
  "bookingRefNum": "BKG123",
  "fikafiRefNum": "FIK7890",
  "status": "resent"
}

📤 Relevant API

POST /takePaymentAction

🔍 Overview#

🧭 Step-by-Step Workflow#

🎯 Available Actions#

📤 Sample Request#