Schemas
E-mail Address of the user
VerificationCode
A randomly generated one-time use code used to verify the user's email address or mobile number.
Error
ManufacturingState
Information on the manufacturing of the physical card, as follows:
- REQUESTED: The upgrade of the card to physical has been requested.
- SENT_FOR_FULFILLMENT - The card has been sent for printing.
- DISPATCHED: The card has been manufactured and dispatched. You may receive a second DISPATCHED event when the manufacturer provides a tracking code.
- DELIVERED: The card has been received and activated by the recipient.
BeneficiaryBatchState
BeneficiaryBatchOperation
Mobile
Date
Tag
The tag field is a custom field that can be used to search and filter.
UserLocale
BCP47 locale code (e.g. en, en-US). The locale determines which email and SMS user notification templates are used.
en-GBBrand
Brand identifier used to determine the set of email and SMS user notification templates. Must be alphanumeric, up to 25 characters, and contain no spaces.
UserId
UpdateCardLevelSpendRules
ProfileId
The profile Id which a specific identity, instrument or transaction type is linked to.
Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.
You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.
Profile Ids can be found in the Multi Portal, in the API Credentials page.
InstrumentId
CurrencyAmount
The object representing a monetary amount in a particular currency.
ScheduledTimestamp
The epoch timestamp at which the transaction is scheduled to be executed.
SendCreateRequest
OutgoingWireTransferCreateRequest
LinkedAccount
UnknownSenderAccount
ManagedAccount
Corporate
Consumer
CardAuthorisationEvent
Accepted shapes
Selected by mode
Prepaid Mode Card Authorisation EventPREPAID_MODEobject
availableBalance- object
Debit Mode Card Authorisation EventDEBIT_MODEobject
parentManagedAccountId*- string
availableToSpend- array<AvailableToSpend · object>
SensitivePassword
The user's password or passcode used to log in a user. Passwords must be:
- between 8 and 30 characters
- include a lowercase character
- include an uppercase character
- include a digit and a special character
- different from any of the 5 last such passwords used.
For non-PCI compliant integrations, the password submitted must be tokenised.
IdentityId
Nonce
A randomly generated one-time use code.
MultipleSCAResourceType
The operation type upon which an SCA Challenge is being contested.
BulkProcessExecute
CompanyPosition
The company position of the Corporate Root User.
CompanyType
Supported company types - if company type is not listed, please contact our support team to check if the company type can be supported.
Address
Industry
The industry of the identity.
CorporateSourceOfFunds
The corporate's source of funds.
Currency
The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.
Fee
Occupation
The industry of the identity.
AddressWithCountryRequired
The address, with none of the separate fields being set as required.
Nationality
Nationality of the user - using ISO 3166 alpha-2.
ConsumerSourceOfFunds
The consumer's source of funds.
KycLevel
The KYC level, which determines what KYC information will be requested from the consumer:
- KYC_LEVEL_1: The most basic level of KYC required.
- KYC_LEVEL_2: Full due diligence level 2
CreateLinkedAccountRequest
ManagedCardRequest
Accepted shapes
Selected by mode
Prepaid Mode Card RequestPREPAID_MODEobject
currency*- string
Debit Mode Card RequestDEBIT_MODEobject
parentManagedAccountId*- string
userCurrency- enum
BillingAddress
DeliveryAddress
The delivery address where the physical card is delivered.
DeliveryMethod
The delivery methods supported for delivering printed physical cards. If not specified, the STANDARD_DELIVERY method will be used.
DigitalWallets
ThreeDSecureAuthConfig
ExternalData
External data fields, as provided and managed by the caller that are to be stored and associated with a Managed Card instance. This information is not processed or used by Weavr but some of the values could be shown in specific reports and used as filters
BulkCardDelivery
Bulk delivery is available for deliveryMethods REGISTERED_MAIL or COURIER. All cards marked as bulk and ordered within the fulfilment centre’s dispatch window will be sent in bulk. Delivery address must be identical for all orders. contactNumber in the deliveryAddress object is mandatory when bulk is selected. Maximum number of cards delivered in a single box/packet is REGISTERED_MAIL = 90, COURIER = 200.
PhysicalCardActivationCode
CardRenewalType
Indicates how the card will be handled once it is close to expiring.
- RENEW: The card will be automatically renewed, keeping the same card number but with a new expiry date and CVV.
- NO_RENEW: Once the expiry date is reached, the card is destroyed.
CardLevelSpendRules
SensitivePin
The PIN used for in-person transactions done with physical cards.
Unless you are PCI-DSS compliant and have opted to switch off Weavr's security model, the card's PIN will be tokenised.
To show the PIN to your user, you need to embed the Display Card PIN UI Component in your application. This accepts the tokenised PIN and shows the plain text PIN to the user on screen.
TransactionBulkCancelRequest
SendBulkCreateRequest
OutgoingWireTransferBulkCreateRequest
TransactionSingleCancelRequest
BasicBeneficiary
TokenType
The auth token received can only be used to access the following endpoints:
/identities/access_token
CredentialId
SyntaxError
Is returned as part of an HTTP error response whenever a syntax error is detected. A list of the fields together with their syntax error will be provided.
TokenError
The used token is expired or not found
UserIdentitiesGetResponseSchema
PasswordInfo
Additional information related to the user's password.
TokenResponse
SCAFactor
Id
User
BulkProcessConflict
BulkProcessDetails
BulkProcessOperationsPaged
CreatedCorporate
KyiStatus
ChargeFee
LinkedAccountVerificationRun
ManagedAccountIBAN
Statement
The list of statement entries.
StatementEntry
ManagedCard
Accepted shapes
Selected by mode
Prepaid Mode CardPREPAID_MODEobject
balances- object
Debit Mode CardDEBIT_MODEobject
parentManagedAccountId*- string
userCurrency- enum
availableToSpend- array<AvailableToSpend · object>
AllLevelSpendRules
Transfer
TransactionBulkCancelResponse
Send
SendBulkCreateResponse
OutgoingWireTransfer
OutgoingWireTransferBulkCreateResponse
BeneficiaryBatch
Beneficiary
SCAOtpChannel
- "SMS": The one-time-password is sent as a text message
SCAPushChannel
- "AUTHY": The push notification is sent on the user's device using Twilio Authy
- "BIOMETRIC": The push notification is sent to the user's device
AuthSCAPushChannel
- "AUTHY": The push notification is sent on the user's device using Twilio Authy
BulkProcessStatus
BulkId
BulkProcessOperationStatus
InstrumentState
The state of the instrument indicating what it can and cannot do as follows:
- ACTIVE: The instrument is in an active state and can be used in transactions.
- BLOCKED: The instrument is temporarily blocked and cannot be used. Any funds on the instrument are also frozen. The
blockedReasonprovides more information as to why it was blocked. - DESTROYED: The instrument has been permanently destroyed. The
destroyReasonprovides more information as to why it was destroyed.
LinkedAccountVerificationRunState
BlockedReason
The reason why the instrument has been blocked:
- USER: The root, or an authorised user, of the identity owning the instrument has temporarily blocked the instrument.
- SYSTEM: The platform or an administrator of the platform has temporarily blocked the instrument.
- LOST: The instrument has been blocked because it was marked as lost.
DestroyedReason
The reason why the instrument has been destroyed:
- SYSTEM: The platform or an administrator of the platform has destroyed the instrument.
- USER: The root, or an authorised user, of the identity owning the instrument has destroyed the instrument.
- LOST: The instrument was automatically destroyed as it was marked as lost.
- STOLEN: The instrument was automatically destroyed as it was marked as stolen.
- EXPIRED: The instrument was automatically destroyed as it expired.
- COMPROMISED: The instrument was automatically destroyed as it was marked as compromised.
TransactionType
TransactionState
Status of the transaction.
InstrumentType
SendState
The state of the send transaction, as follows:
- INVALID: The send transaction has failed initial validation checks.
- INITIALISED: The initial state of a send transaction when SCA is not required.
- PENDING_CHALLENGE: The send transaction requires the completion of a transaction confirmation challenge before it can be submitted.
- PENDING: The send transaction has exceeded the destination limit and is pending treasury approval.
- APPROVED: The send transaction that was submitted has been approved.
- COMPLETED: The requested funds have been sent from the source instrument.
- REJECTED: The send transaction that was submitted was rejected.
- FAILED: There was an issue with the send transaction, and the transaction has failed.
- RETURNED: The send transaction has been returned to the sender.
- SCHEDULED: The send transaction will be executed at the scheduled time.
- CANCELLED: The scheduled send transaction has been cancelled.
SourceInstrumentType
OutgoingWireTransferState
The state of the Outgoing wire transfer transaction, as follows:
- INVALID: The wire transfer has failed initial validation checks.
- PENDING_CHALLENGE: The wire transfer requires the completion of a transaction confirmation challenge before it can be submitted.
- SUBMITTED: The wire transfer has been submitted to the sending financial institution for processing.
- REJECTED: The wire transfer that was submitted was rejected.
- APPROVED: The wire transfer that was submitted has been approved and is being processed by the sending financial institution.
- FAILED: There was an issue with the wire transfer, and the transaction has failed.
- COMPLETED: The requested funds have been sent from the source instrument.
- RETURNED: The wire transfer has been returned to the sender.
- SCHEDULED: The wire transfer will be executed at the scheduled time.
- CANCELLED: The scheduled wire transfer has been cancelled.
- PENDING_CONFIRMATION: The wire transfer requires a manual confirmation by the user before proceeding.
BulkProcess
SpendLimitUpdateMethod
The spend limit update method to apply. Currently supported:
- OVERWRITE: (default option if nothing selected). Overwrites the previous values for the spendLimit object i.e. sets new limits
- INCREMENT : This will increase the existing value of the spend limit by the amount input the value field. If used in conjunction with an ALWAYS interval, this can be used to increment a spend limit on a periodic basis (controlled by you, e.g. monthly), and means that any 'unused' balance from the previous period will still available to spend. See examples in our documentation
BeneficiaryId
OutgoingWireTransferBeneficiary
Details of the beneficiary of the outgoing wire transfer.
ExternalAccountId
The id of an external account, such as a Linked Account, registered with the Weavr Platform.
AccountType
An account can be of two types, Personal or Business:
- PERSONAL means that the account held at the external bank or PSP is registered under the ownership of a natural person or consumer identity;
- BUSINESS means that the account held at the external bank or PSP is registered under the ownership of a corporate entity.
AccountNumberAndSortCode
Bank details
Iban
Bank details
AccountDescriptor
Identifier or account number which does not follow either the IBAN or Faster Payment (sort code and account number) format, such as a US bank account identifier.
LinkedAccountState
The state of the linked account:
- PENDING_VERIFICATION: The Linked Account is pending the completion of the required verification steps.
- ACTIVE: The Linked Account is verified and active, ready to be used for self-to-self wire transfers.
- BLOCKED: The Linked Account is temporarily blocked, preventing any use of this external account in self-to-self wire transfers. A Linked Account can be unblocked by calling the Multi API endpoint
POST /linked_accounts/{id}/unblock. - REMOVED: The Linked Account has been removed from the platform and can no longer be used for self-to-self wire transfers unless a new verification is completed in future.
- REJECTED: The Linked Account failed the verification process and cannot be used for self-to-self wire transfers unless a new verification is completed in future.
A Linked Account can transition through these different overall states, starting at the
PENDING_VERIFICATIONstate until all verification steps are followed through.
StringWrappedTypeId
ManagedInstrumentBalance
Instruments with funds have 2 balances, the availableBalance indicating the funds that are available for transactions such as purchases, and the actualBalance indicating the funds that are actually on the instrument.
ManagedInstrumentState
CorporateRootUser
LegalAddress
The legal address of the company. This information is captured via the Due Diligence (KYB) process.
ConsumerRootUser
CardAuthorisationDetailsAuthorisationType
MerchantData
CardHolderPresent
PrepaidModeCardAuthorisationEvent
DebitModeCardAuthorisationEvent
BulkProcessMode
ON_FAILURE_STOP : the execution of the bulk process stops after the first bulk operation that fails (operation returns a 4xx or 5xx response code). ON_FAILURE_CONTINUE: the execution of the bulk process resumes as normal even when any of the bulk operations fail.
LinkedAccountProfileId
The id of the Linked Account Profile which this instrument is linked to.
You can have one or more profiles linked to your application, and these can be used to drive different behaviours according to your product's needs.
This field is necessary only if you have been provided with multiple Linked Account Profiles.
Profile Ids can be found in the Multi Portal, in the API Credentials page.
PrepaidModeCardRequest
DebitModeCardRequest
PhoneNumber
BaseCardLevelSpendRules
TransactionCancelRequest
TransactionCancellationReason
The reason the scheduled transaction was cancelled.
BeneficiaryTrustLevel
The value that determines whether a Beneficiary is trusted or not.
BusinessBeneficiaryType
ConsumerBeneficiaryType
InstrumentDetailsBeneficiary
Represents a Weavr beneficiary instrument typically used in Send transactions.
BankAccountDetailsBeneficiary
Represent the beneficiary bank account typically used in Outgoing Wire Transfer transactions.
UserIdentity
SCAChallengeType
- "OTP": The OTP is sent as a text message
- "PUSH": The authorisation request is sent as a push notification
- "BIOMETRIC": The push notification is sent via Firebase to a mobile application
SCAFactorStatus
The state of the factor type.
PENDING_VERIFICATION: The user has started the enrolment process but still hasn't completed enrolment. Challenges cannot be used before they are verified.ACTIVE: The user has successfully completed enrolment and the challenge can be used to verify transactions.INACTIVE: The user has rejected the enrolment.
SCAChannel
- "SMS": The one-time-password is sent as a text message
- "AUTHY": The push notification is sent to an Authy application
- "BIOMETRIC": The push notification is sent to an innovator application
BulkProcessConflictErrorCode
BulkProcessOperationStatusCounts
BulkProcessOperation
CreatedCorporateRootUser
TransactionId
LinkedAccountVerificationStep
LinkedAccountVerificationTransferInstruction
LinkedAccountMicroDepositVerification
LinkedAccountVerificationStepStatus
IBANDetails
Bank details used in case the wire transfer is executed over SEPA or RIX
FasterPaymentsBankDetailsOrBACSBankDetails
Bank details used in case the wire transfer is executed over Faster Payments.
SwiftBankDetails
Bank details used in case the wire transfer is executed over SWIFT.
StatementEntryState
The transaction entry state, as follows:
- PENDING: The transaction has started and some of the fund movements have completed, however additional fund movements are still pending to finalise the transaction.
- COMPLETED: All fund movements for a transaction have completed.
ScaledAmount
A floating point number, represented as a value and its scale. Its actual value can be obtained using the equation: value * pow(10, -scale).
UserCurrencyTransactionDetails
The object representing the user transaction's currency, amount and rate.
SensitiveCardNumber
The full card number of the card.
Unless you are PCI-DSS compliant and have opted to switch off Weavr's security model, the card number will be tokenised.
To show the full unredacted card number to your user, you need to embed the Card number UI Component in your application. This accepts the tokenised card number and shows the unredacted card number to the user on screen.
SensitiveCvv
The CVV of the card.
Unless you are PCI-DSS compliant and have opted to switch off Weavr's security model, the card's CVV will be tokenised.
To show the card's CVV to your user, you need to embed the CVV UI Component in your application. This accepts the tokenised CVV and shows the plain text CVV number to the user on screen.
PhysicalCardDetails
ManagedCardReplacement
Indicates if the card is replaced by another card.
PrepaidModeCard
DebitModeCard
SpendLimit
ProfileLevelSpendRules
IdentityLevelSpendRules
ExecutionTimestamp
The epoch timestamp at which the transaction was executed, transitioning to a final state such as COMPLETED, REJECTED, or FAILED.
TransactionCancelResponse
ChallengeExemptionReason
The Reason the transaction was exempted from SCA verification
OutgoingWireTransferType
The wire transfer rails used, from SEPA, Faster Payments or SWIFT.
OutgoingWireTransferRejectedInfo
Additional info when the outgoing wire transfer has been rejected, as follows:
- SYSTEM: The wire transfer was rejected by the system.
- USER: The wire transfer was rejected by the user.
OutgoingWireTransferValidationOutcome
BeneficiaryOperationBatchId
BeneficiaryState
BeneficiaryValidationFailure
DateOfBirth
The date of birth in ISO 8601 format (YYYY-MM-DD).
ExternalAccountType
AddressWithNoRequiredFields
The address, with none of the separate fields being set as required.
AvailableToSpend
SupportedUserCurrency
CommonLevelSpendRules
DeliveryTrackingCode
The delivery tracking code for tracking the physical card's delivery status. This may not always be available on the first dispatched event, and so you will receive an additional dispatched notification with the delivery tracking code populated as soon as it is available.
DeliveryTrackingMethod
The delivery tracking method for tracking the physical card's delivery status.
DeliveryTrackingUrl
The delivery tracking URL for tracking the physical card's delivery status.
SpendLimitInterval
The time period for which the spendLimit is valid.
-
DAILY: starting from 00:00:00 UTC of current day to 23:59:59 UTC of current day
-
WEEKLY: 00:00:00 UTC Monday of current week to following Sunday 23:59:59 UTC
-
MONTHLY: 1st of current calendar month to end of current calendar month
-
QUARTERLY: starting from beginning of current quarter where quarters are defined as follows:
-
1 January 00:00:00 UTC to 31 March 23:59:59 UTC
-
1 April 00:00:00 UTC to 30 Jun 23:59:59 UTC
-
1 July 00:00:00 UTC to 30 September 23:59:59 UTC
-
1 October 00:00:00 UTC to 31 December 23:59:59 UTC
-
YEARLY: 1 January 00:00:00 UTC of current calendar year to 31 December 23:59:59 UTC of current calendar year.
-
ALWAYS: This indicates that the
spendLimitis the total amount that can be spent through the card throughout the whole lifetime of the card.
UKConfirmationOfPayeeResult
RolloverPolicy
The rollover policy will dictate how Weavr handles any eventual overspending. This is possible if a merchant clears more funds than authorised, or when a merchant clears funds without authorising, resulting in the availableToSpend value to go into negative. Rollover is relative to a spendLimit.interval