Skip to main content

Get wallet payment instruments

GET 

/instruments

deprecated

Retrieve list of active instruments for the customer.

For cards, the PAN will be returned masked in the format 5xxxxxxxxxxx2922. For bank accounts, the IBAN will be returned masked in the format NL94xxxxxxxxxxx464 and the bank account number will be returned masked in the format 77xxxxx464.

This API is deprecated! Use the alternative /customers/{customerId}/instruments instead.

Request

Query Parameters

    customerId stringrequired

    Id of the customer to fetch instruments for

Responses

OK

Schema

  • Array [

  • id string

    The instrument id

    customerId string

    The customer to which this instrument belongs.

    instrumentType

    string

    required

    Possible values: [CARD, SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT, CCI_BANK_ACCOUNT]

    Represents the type of the instrument.

    ValueDescription
    SEPA_BANK_ACCOUNTSEPA Bank account
    UK_BANK_ACCOUNTUK Bank account
    US_BANK_ACCOUNTUS Bank account
    CCI_BANK_ACCOUNTCCI Bank account
    CARDCard
    pan stringrequired

    Card number.

    cardHolderName string

    Possible values: <= 160 characters

    Card holder name.

    bankName string

    The bank name.

    expiryDate

    object

    required

    Card expiry date.

    year integerrequired
    month integerrequired
    cardScheme CardScheme (string)

    Possible values: [VISA, MC]

    Card scheme information.

    • VISA - VISA
    • MC - Mastercard The scheme is derived from the card PAN.
    description string

    Possible values: <= 20 characters

    Name to be associated with the card.

    externallyVerified booleandeprecated

    Is the instrument externally verified. The property is not returned by the API anymore.

    status string

    Possible values: [VERIFIED, UNVERIFIED, VERIFICATION_REQUIRED, REJECTED]

    The instrument status.

    creationTime date-time

    Represents RFC 3339, section 5.6 date-time.

  • ]

Loading...