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"
}