Form Validation

🚧

Hosted Payments Page form validation errors are propagated to the parent frame (merchant website) via fz.form_validation.error event.

fz.form_validation.error Data Payload

Example

{
  "message": "Form was not valid",
  "errors": [
    "Expiry Date is required",
    "Security Code (CVV) is required"
  ],
  "data": {
    "payment_request_expiry_date": [
      {
        "errorCode": "hpp_10401",
        "message": "Expiry Date is required"
      }
    ],
    "payment_request_security_code": [
      {
        "errorCode": "hpp_10301",
        "message": "Security Code (CVV) is required"
      }
    ]
  }
}

• errors contains an array of messages associated with the form validation errors.
• data provides details around the affected fields and the associated errors, along with error codes. Developers can take advantage of the error code in order to customise the user experience.

Validation Rules