POST
/
expire-pay
Expire a Payment Transaction
curl --request POST \
  --url https://sandbox.fapshi.com/expire-pay \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --header 'apiuser: <api-key>' \
  --data '{
  "transId": "<string>"
}'
{
  "transId": "<string>",
  "status": "EXPIRED",
  "medium": "mobile money",
  "serviceName": "<string>",
  "amount": 123,
  "revenue": 123,
  "payerName": "<string>",
  "email": "jsmith@example.com",
  "redirectUrl": "<string>",
  "externalId": "<string>",
  "userId": "<string>",
  "webhook": "<string>",
  "financialTransId": "<string>",
  "dateInitiated": "2023-12-25",
  "dateConfirmed": "2023-12-25"
}

Endpoint

POST /expire-pay

Expire a payment link to prevent further payments.

Parameters

NameRequiredTypeDescription
transIdYesstringID of the transaction to expire

Response

  • Returns details of the expired transaction if successful.
  • Returns 400 Bad Request with message "Link already expired" if the transaction was already expired.

Authorizations

apiuser
string
header
required
apikey
string
header
required

Body

application/json

Response

200
application/json

Payment link expired successfully

The response is of type object.