iOS events

The following events can be raised by the iOS SDK. transactionCreated Returns data about the transaction object when the transaction was successfully created.

{
  "transactionID": "8724fd24-5489-4a5d-90fd-0604df7d3b83",
  "status": "pending",
  "paymentMethodID": "17d57b9a-408d-49b8-9a97-9db382593003"
}

transactionFailed Returned when the transaction encounters an error.

{
  "transactionID": "8724fd24-5489-4a5d-90fd-0604df7d3b83",
  "status": "pending",
  "paymentMethodID": "17d57b9a-408d-49b8-9a97-9db382593003"
}

When a network error occurs, the payload includes a responseCode.

{
  "transactionID": "",
  "status": "",
  "paymentMethodID": null,
  "responseCode": "ETIMEDOUT",
}

Here’s a list of potential values for responseCode:

Code	Definition
`ERR_BAD_OPTION_VALUE`	Invalid or unsupported value provided in axios configuration.
`ERR_BAD_OPTION`	Invalid option provided in axios configuration.
`ECONNABORTED`	Request timed out due to exceeding timeout specified in axios configuration.
`ETIMEDOUT`	Request timed out due to exceeding default axios time limit.
`ERR_NETWORK`	Network-related issue.
`ERR_FR_TOO_MANY_REDIRECTS`	Request is redirected too many times; exceeds max redirects specified in axios configuration.
`ERR_DEPRECATED`	Deprecated feature or method used in axios.
`ERR_BAD_RESPONSE`	Response cannot be parsed properly or is in an unexpected format.
`ERR_BAD_REQUEST`	Requested has unexpected format or missing required parameters.
`ERR_CANCELED`	Feature or method is canceled explicitly by the user.
`ERR_NOT_SUPPORT`	Feature or method not supported in the current axios environment.
`ERR_INVALID_URL`	Invalid URL provided for axios request.

cancelled Returned when the user closes the payment sheet without creating a transaction. generalError Returned when the SDK encounters an error.

{
  "Gr4vy Error: Failed to load"
}

cardDetailsChanged Returned when the card BIN changes in the form. It contains information on the inputted card, such as the BIN, card type and scheme.

{
  "bin": "42424242",
  "scheme": "visa",
  "cardType": "debit"
}

Get started

Integration guides

Best Practices

Resources

Features

Other