Skip to main content

Release 17.07.2026

Changelog​

Submit Card Owner KYC​

warning

Breaking Change
This request now requires the new sourceOfFund and livingAddress fields.

The following changes have been made to the Submit Card Owner KYC request:

  • Two required fields have been added to the request body:
    • sourceOfFund: Source of the card owner's funds. One of SALARY_OR_EMPLOYMENT_INCOME, PENSION_OR_RETIREMENT_BENEFITS, FINANCIAL_SUPPORT_FROM_IMMEDIATE_FAMILY, BUSINESS_PROFITS, INCOME_FROM_SOLE_PROPRIETORSHIP, PROCEEDS_FROM_PERSONAL_INVESTMENTS, DIVIDENDS_OR_SHARE_DISTRIBUTIONS, LOAN_PROCEEDS, INHERITANCE, or DONATION_OR_GIFT.
    • livingAddress: Living address of the card owner. Contains livingCountry (ISO 3166-1 alpha-2 country code) and street.
  • The optional addressProofFile field has been added to the request body. It indicates which side of the uploaded identity document, FRONT or BACK, shows the residential address, and is required when the address cannot be located on the map.
  • The document.type field now supports two additional values, DRIVER_LICENSE and RESIDENCE_PERMIT, in addition to the existing PASSPORT and ID_CARD.

Retrieve Card Owner Data​

The objectUploaded object has been added to each KYC record in the kyc array returned by Retrieve Card Owner Data. It indicates which sides of the identity document have been processed by the provider. Each side becomes true only after the uploaded file has been processed, not immediately after upload.

  • front: Whether the front side of the document has been processed by the provider.
  • back: Whether the back side of the document has been processed by the provider.

Uploaded document files are not retained. If a KYC submission is denied, upload the identity document again and submit a new KYC application.

Retrieve Available BINs​

The bins.country field returned by Retrieve Available BINs is now optional and can be null if the country is not specified for the BIN.