Issue Pass - mynztrip

Issue Flight Delay Pass

POST Endpoint: [BaseUrl]/api/v1/flight-delay-pass/issue-pass

Overview

The Issue Pass API creates and issues a flight delay pass for a passenger. This endpoint generates pass codes and booking confirmation details.

Authentication

This endpoint requires Bearer token authentication. Include your access token in the Authorization header.

Request Parameters

Parameter	Type	Required	Description
uniqueTransId	String	Yes	Unique transaction ID from get-price API
productCode	String	Yes	Product code (e.g., GMAT60MINS)
passengerCount	Integer	Yes	Number of passengers (minimum 1)
passenger_name	String	Yes	Full name of the passenger
passenger_email	String	Yes	Email address of the passenger
passenger_mobile	String	Yes	Mobile number of the passenger
passenger_country_code	String	Yes	Country code for the mobile number (e.g., +60)

Request Headers

Header	Type	Required	Description
Authorization	String	Yes	Bearer token for authentication
Content-Type	String	Yes	application/json

Request

{
  "uniqueTransId": "NZFDP2508061933445232",
  "productCode": "GMAT60MINS",
  "passengerCount": 1,
  "passenger_name": "John Doe",
  "passenger_email": "john.doe@example.com",
  "passenger_mobile": "1234567890",
  "passenger_country_code": "+60"
}

Response

{
  "success": true,
  "uniqueTransId": null,
  "code": 200,
  "message": "Flight delay pass issued successfully",
  "data": {
    "bookingId": 25,
    "uniqueTransId": "NZFDP2510121249",
    "pnr": "1544027937",
    "passCodes": [
      "GMAT60MINSABC1461"
    ],
    "issueCodeRef": "7zcak11bsVknZW3mO8gJKjxDzL3UzCkt8zbMyCnhd1ZcF1Vujd/eVthjtAVojs9Gvw/4HAN51zPBJPMyDNUGeLjtodVyfE8J+2UqNC7FLQQ=",
    "totalPrice": "0.00",
    "currency": "BDT",
    "passengerCount": 1,
    "passengerName": "John Doe",
    "passengerEmail": "john.doe@example.com",
    "passengerMobile": "1234567890",
    "passengerCountryCode": "+60",
    "status": "ISSUED",
    "redeemUrl": "https://fdp.mastercard.com/mynztrip"
  }
}

Response Fields

Field	Type	Description
success	Boolean	Indicates if the request was successful
code	Integer	HTTP status code
message	String	Response message
data.bookingId	Integer	Internal booking ID
data.uniqueTransId	String	Transaction ID for this booking
data.pnr	String	Passenger Name Record number
data.passCodes	Array	Array of generated pass codes for passengers
data.issueCodeRef	String	Encrypted reference code for the issued pass
data.totalPrice	Decimal	Total price charged for the pass
data.currency	String	Currency code
data.passengerCount	Integer	Number of passengers
data.passengerName	String	Passenger full name
data.passengerEmail	String	Passenger email
data.passengerMobile	String	Passenger mobile number
data.passengerCountryCode	String	Country code
data.status	String	Booking status (ISSUED, VOIDED, etc.)

Product Codes

Product Code	Description	Coverage
GMAT60MINS	Flight Delay Pass	60 minutes delay coverage

Status Values

Status	Description
ISSUED	Pass has been successfully issued
VOIDED	Pass has been cancelled/voided
PENDING	Pass issuance is in progress

Important Notes

The uniqueTransId from get-price API must be used within its validity period
Pass codes are unique identifiers for each passenger's delay pass
Store the pnr and passCodes securely as they're needed for customer service
The issueCodeRef is an encrypted reference that may be required for support queries
Email notifications are automatically sent to the passenger email address

Error Handling

Common error scenarios:

Invalid uniqueTransId: The transaction ID has expired or is invalid
Invalid product code: The specified product code doesn't exist
Validation errors: Missing or invalid passenger information
Insufficient balance: Agent account doesn't have sufficient credit

Next Steps

After issuing a pass, you can:

View Booking Details using the uniqueTransId
Send Cancel Request if cancellation is needed

Get Price Booking Details