Sign in
Instant Top-Ups

Index Top-Ups for a person's account

Returns an array containing all Top-Ups for the person's account specified in the request URL.

get/v1/persons/{person_id}/accounts/{account_id}/topups

Path parameters

person_idstring required
account_idstring required

Query parameters

filter[status]'ACCEPTED' | 'CONFIRMED' | 'EXECUTED' | 'DECLINED' | 'CANCELLED'

The current status of the Top-Up.

Filter the results by the status of the Top-Up.

filter[instruction_id]string

Filter the results by the instruction_id

Response

The operation was successful.

idstring required

Unique ID of the Top-Up.

acquirer_error_codestring nullable

Error code forwarded by the Acquirer's API (in case there was an error on the Acquirer's end).

acquirer_decline_codestring nullable

If the Acquirer declines the Top-Up, then this property will contain the decline code forwarded by the Acquirer's API.

cancellation_reason'abandoned' | 'duplicate' | 'fraudulent' | 'requested_by_customer' nullable

The reason why the Top-Up was cancelled. Only present if the status is 'CANCELLED'.

decline_reasonstring nullable

The reason why the Top-Up was declined. Usually present if the status is 'DECLINED' due to a technical issue.

client_secretstring

The client secret key provided by the Acquirer's API for use in their frontend SDK.

status'ACCEPTED' | 'CONFIRMED' | 'EXECUTED' | 'DECLINED' | 'CANCELLED' required

The current status of the Top-Up.

instruction_idstring nullable

Instruction ID of the Solaris credit transfer transaction.

Example response

[
  {
    "id": "b76cdcc321d345618084feedc47bbb1d",
    "amount": {
      "value": 10000
    },
    "client_secret": "pi_1DrPlP2eZvKYlo2CSBQ7uqFH_secret_o1A7UsYFLWeGISUD1QYNkT8IU",
    "instruction_id": "3eba1ee2d8bc4d5883d350031a5fe9d8"
  }
]