Skip to main content

VirtualInstrumentRequestStatusList

List of virtual payment instrument request statuses.

virtualInstrumentRequestStatuses object[]
  • Array [
  • idstring

    Id of the request

    Possible values: <= 20 characters

    Example: 5029090724
    instrumentTypeVirtualInstrumentType (string)required

    Virtual payment instrument type.

    Possible values: [SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT]

    Example: US_BANK_ACCOUNT
    requestDatedate-timerequired
    Example: 2019-08-24T14:15:22Z
    lastChangeDatedate-time
    Example: 2019-08-24T16:15:22Z
    accountIdstring

    Id of balance account linked to the virtual instrument.

    Example: 123234
    statusstringrequired

    Status of virtual payment instrument request.

    Possible values: [ACCEPTED, PENDING, COMPLETED, REJECTED, FAILED]

    Example: COMPLETED
    statusReasonstring

    Status of virtual payment instrument request.

    Example: Request has been denied by the issuing bank.
    virtualInstrumentIdstring

    When the status of the request is COMPLETED, holds the id of the virtual instrument.

    Possible values: <= 20 characters

    Example: acde070d-8c4c-4f0d-9d8a-162843c10335
  • ]
  • meta object

    Contains paging information regarding the returned records, when response is paginated.

    The input for paginated query contains two parameters:

    • limit - This is the requested number of records to return. Defaults to 10 and maximum is 50.
    • offset - This is the requested starting position of the response, where 0 is the first record. Default = 0.

    Note! The total number of records is not returned, to prevent queries spanning on all records. If numberOfRecords<limit, this means no further pages are available. On request of offset beyond the last record, the returned numberOfRecords is 0.

    The number of previous pages can be calculated by dividing offset to limit.

    numberOfRecordsinteger

    This is the number of records returned in the lookup. Always numberOfRecords is smaller than or equal to limit.

    Example: 1
    limitinteger

    This is the requested number of records to be returned per page.

    Example: 10
    offsetinteger

    This is the requested starting position of the response, where 0 is the first record.

    Example: 0
    pageinteger

    This is the page of records on which the lookup starts. The starting page is 1.

    Example: 1
    VirtualInstrumentRequestStatusList
    {
    "virtualInstrumentRequestStatuses": [
    {
    "id": "5029090724",
    "instrumentType": "US_BANK_ACCOUNT",
    "requestDate": "2019-08-24T14:15:22Z",
    "lastChangeDate": "2019-08-24T16:15:22Z",
    "accountId": "123234",
    "status": "COMPLETED",
    "statusReason": "Request has been denied by the issuing bank.",
    "virtualInstrumentId": "acde070d-8c4c-4f0d-9d8a-162843c10335"
    }
    ],
    "meta": {
    "numberOfRecords": 1,
    "limit": 10,
    "offset": 0,
    "page": 1
    }
    }