Weavr API
Use Weavr Multi API to embed accounts, cards, and payments directly in your product.
Authentication
Each request to the Multi API must include an api-key that represents your account.
Almost all endpoints require a secondary authentication token access_token that represents the user for whom the request is being executed.
Corporates
Corporates are identities representing companies. Once on-boarded, Corporates can create and manage their own instruments via your application.
/corporatesGet a corporateGET/corporatesUpdate a corporatePATCH/corporatesStart KYB for a corporatePOST/corporates/kybGet KYB for a corporateGET/corporates/kybSubmit known KYB entity data for a corporatePOST/corporates/{corporateId}/kyb/entityGet the submitted KYB entity data for a corporateGET/corporates/{corporateId}/kyb/entitySubmit the KYB account-usage profile for a corporatePOST/corporates/{corporateId}/kyb/profileGet the submitted KYB account-usage profile for a corporateGET/corporates/{corporateId}/kyb/profileUpload a KYB supporting document for a corporatePOST/corporates/{corporateId}/kyb/documentsList the uploaded KYB documents for a corporateGET/corporates/{corporateId}/kyb/documentsCorporate KYB status updateWebhook/corporates/kyb/watchCorporate beneficiary status updateWebhook/corporates/kyb/beneficiaries/watchCorporate activationWebhook/corporates/corporate_activated/watchCorporate deactivationWebhook/corporates/corporate_deactivated/watchConsumers
Consumers are identities representing individuals. Once on-boarded, Consumers can create and manage their own instruments via your application.
/consumersGet a consumerGET/consumersUpdate a consumerPATCH/consumersStart KYC for a consumerPOST/consumers/kycGet KYC for a consumerGET/consumers/kycConsumer KYC status updateWebhook/consumers/kyc/watchConsumer activationWebhook/consumers/consumer_activated/watchConsumer deactivationWebhook/consumers/consumer_deactivated/watchSetup
Register and manage the lifecycle of users that can access an identity, including authorized users invited by a Corporate or Consumer root user.
/usersList usersGET/usersGet a userGET/users/{user_id}Update a userPATCH/users/{user_id}List linked identitiesGET/identitiesInvite a user to set a passwordPOST/users/{user_id}/inviteValidate a user's invitePOST/users/{user_id}/invite/validateAccept a user invitationPOST/users/{user_id}/invite/consumeLink an existing user to your identityPOST/users/{user_id}/linkSend an email verification code to a userPOST/users/verification/email/sendVerify email of the authorized userPOST/users/verification/email/verifyDeactivate an authorized userPOST/users/{user_id}/deactivateReactivate an authorized userPOST/users/{user_id}/activateStart signatory verificationPOST/users/kycUser deactivationWebhook/auth/users/user_deactivated/watchSign-in
Sign users in using passwords, biometrics, or third-party auth providers.
Step-up challenges
Issue and verify step-up challenges that elevate an existing user token.
Confirmation challenges
Issue and verify confirmation challenges used to authorize lists of resources.
/challenges/otp/{channel}Verify a list of resources using a one-time passwordPOST/challenges/{scaChallengeId}/otp/{channel}/verifyIssue a push notification that can be used to verify a list of resourcesPOST/challenges/push/{channel}Authentication factors
Manage user authentication factors, including passwords and device-based factors (OTP and push).
/passwords/{user_id}/createUpdate a passwordPOST/passwords/updateValidate a passwordPOST/passwords/validateStart password recoveryPOST/passwords/lost_password/startContinue password recoveryPOST/passwords/lost_password/resumeList user authentication factorsGET/authentication_factorsEnroll a user device for authentication using one-time passwordsPOST/authentication_factors/otp/{channel}Verify enrollment of a user device for authentication using one-time passwordsPOST/authentication_factors/otp/{channel}/verifyEnroll a user device for authentication using push notificationsPOST/authentication_factors/push/{channel}Unlink a user device for authentication using push notificationsDELETE/authentication_factors/push/{channel}Authentication factor enrollmentWebhook/authentication_factors/watchAccess tokens
Acquire and revoke access tokens.
Authorised signatories
Verify the email of root users who act as authorized signatories of a Corporate or Consumer identity.
/corporates/verification/email/sendVerify email of the corporate root userPOST/corporates/verification/email/verifySend an email verification code to the consumer root userPOST/consumers/verification/email/sendVerify email of the consumer root userPOST/consumers/verification/email/verifyTrusted payees
Manage a list of trusted payees for Outgoing wire transfers and Sends.
Aside from convenience and a reduced chance of making errors when making transactions,
this allows for the introduction an SCA exemption, where the account holder can request
that transactions to TRUSTED payees to be exempted from the requirement to pass
an SCA challenge every time.
/beneficiariesList payeesGET/beneficiariesRemove payeesPOST/beneficiaries/removeGet a payeeGET/beneficiaries/{id}List payee batchesGET/beneficiaries/batchGet a batch of payeesGET/beneficiaries/batch/{id}Send a one-time password to verify a payee batchPOST/beneficiaries/batch/{id}/challenges/otp/{channel}Verify a payee batch using a one-time passwordPOST/beneficiaries/batch/{id}/challenges/otp/{channel}/verifySend a push notification to verify a payee batchPOST/beneficiaries/batch/{id}/challenges/push/{channel}Payee batch state changeWebhook/beneficiaries/batch/watchManaged accounts
Managed Accounts are a type of financial instrument offered by Weavr.
They hold funds for their owner, and can be upgraded to IBANs so as to receive and send funds to instruments outside of the Weavr Platform, via Wire Transfers.
Managed accounts can also be used as source and destination instruments in the transfer and send transactions.
/managed_accountsCreate an accountPOST/managed_accountsGet an accountGET/managed_accounts/{id}Update an accountPATCH/managed_accounts/{id}Add an IBAN to an accountPOST/managed_accounts/{id}/ibanGet an account IBANGET/managed_accounts/{id}/ibanBlock an accountPOST/managed_accounts/{id}/blockUnblock an accountPOST/managed_accounts/{id}/unblockGet an account statementGET/deprecated/managed_accounts/{id}/statementGet an account statementGET/managed_accounts/{id}/statementDownload an account statement as a PDFGET/managed_accounts/{id}/statement/pdfList account transactionsGET/managed_accounts/{id}/transactionsGet an account transactionGET/managed_accounts/{id}/transactions/{transactionId}Remove an accountPOST/managed_accounts/{id}/removeIBAN state changeWebhook/ibans/watchManaged account state changeWebhook/managed_accounts/watchIncoming wire transfer receivedWebhook/managed_accounts/deposits/watchManaged cards
Managed Cards are a type of financial instrument offered by Weavr.
You can create virtual or physical cards that are issued to the consumer or corporate identity.
A card created in prepaid mode has its own balance, whereas a card created in debit mode does not have its own balance but taps into the balance of its parent managed account.
/managed_cardsCreate a prepaid cardPOST/managed_cards#prepaidCreate a debit cardPOST/managed_cards#debitGet a cardGET/managed_cards/{id}Update a cardPATCH/managed_cards/{id}Block a cardPOST/managed_cards/{id}/blockUnblock a cardPOST/managed_cards/{id}/unblockRemove a cardPOST/managed_cards/{id}/removeDownload a card statement as a PDFGET/managed_cards/{id}/statement/pdfRequest a physical card for individual deliveryPOST/managed_cards/{id}/physical#individualRequest a physical card for bulk deliveryPOST/managed_cards/{id}/physical#bulkActivate a physical cardPOST/managed_cards/{id}/physical/activateGet PIN for a physical cardGET/managed_cards/{id}/physical/pinUnblock PIN for a physical cardPATCH/managed_cards/{id}/physical/pin/unblockReplace a damaged physical cardPOST/managed_cards/{id}/physical/replace_damagedReport a physical card as lostPOST/managed_cards/{id}/physical/report_lostReport a physical card as stolenPOST/managed_cards/{id}/physical/report_stolenReplace a lost or stolen physical cardPOST/managed_cards/{id}/physical/replace_lost_stolenReset contactless limit for a physical cardPOST/managed_cards/{id}/physical/contactless_limit/resetPhysical card fulfillment statusWebhook/managed_cards/physical_cards_upgrade/watchManaged card state changeWebhook/managed_cards/state_change/watchCard authorizationWebhook/managed_cards/authorisations/watchManaged card balance adjustmentWebhook/managed_cards/adjustments/watchCard settlementWebhook/managed_cards/settlements/watchManaged card expiry and renewalWebhook/managed_cards/expiries/watchManaged card replacementWebhook/managed_cards/replacement/watchTransfers
The Transfer transaction is used to transfer funds between managed accounts and managed cards belonging to same identity.
Transaction activity
Retrieve the consolidated transaction activity across instruments.
Incoming wire transfers
Incoming wire transfers received from external bank accounts to managed accounts with IBANs.
Outgoing wire transfers
The Outgoing Wire Transfer transaction is used to transfer funds from managed accounts to an external bank account.
/outgoing_wire_transfersList outgoing wire transfersGET/outgoing_wire_transfersGet an outgoing wire transferGET/outgoing_wire_transfers/{id}Update the beneficiary name of an outgoing wire transferPATCH/outgoing_wire_transfers/{id}Get an outgoing wire transfer payment confirmationGET/outgoing_wire_transfers/{id}/payment_confirmationCancel an outgoing wire transferPOST/outgoing_wire_transfers/{id}/cancelConfirm an outgoing wire transferPOST/outgoing_wire_transfers/{id}/confirmIssue a one-time password that can be used to verify an outgoing wire transferPOST/outgoing_wire_transfers/{id}/challenges/otp/{channel}Verify an outgoing wire transfer using a one-time passwordPOST/outgoing_wire_transfers/{id}/challenges/otp/{channel}/verifyIssue a push notification that can be used to verify an outgoing wire transferPOST/outgoing_wire_transfers/{id}/challenges/push/{channel}Outgoing wire transfer state changeWebhook/outgoing_wire_transfers/watchCorrespondent bank transfers
Correspondent bank transfers allow financial institutions to initiate wire transfers on behalf of originators (third parties). These transfers comply with travel rule requirements by capturing and transmitting originator information.
/correspondent_bank_transfersList correspondent bank transfersGET/correspondent_bank_transfersGet a correspondent bank transferGET/correspondent_bank_transfers/{id}Cancel a correspondent bank transferPOST/correspondent_bank_transfers/{id}/cancelConfirm a correspondent bank transferPOST/correspondent_bank_transfers/{id}/confirmCard payments
Retrieve card payment activity, including authorizations, settlements, and related events.
Spend controls
Manage spend rules and authorization forwarding to approve or reject card payments in real time.
/managed_cards/{id}/spend_rulesCreate spend rules for a cardPOST/managed_cards/{id}/spend_rulesUpdate spend rules for a cardPATCH/managed_cards/{id}/spend_rulesDelete all spend rules for a cardDELETE/managed_cards/{id}/spend_rulesApprove or reject card paymentsWebhook/managed_cards/authorisation_requestSends
The Send transaction is used to send funds between managed accounts and managed cards belonging to different identities.
/sendsList sendsGET/sendsGet a sendGET/sends/{id}Cancel a sendPOST/sends/{id}/cancelIssue a one-time password that can be used to verify a sendPOST/sends/{id}/challenges/otp/{channel}Verify a send using a one-time passwordPOST/sends/{id}/challenges/otp/{channel}/verifySend a push notification to verify a sendPOST/sends/{id}/challenges/push/{channel}Send state changeWebhook/send/watchFees
Charge and retrieve in-platform fees.
Operations
Submit supported API operations for asynchronous bulk processing.
/bulks/usersSend user invites in bulkPOST/bulks/users/_user_id_/inviteBlock cards in bulkPOST/bulks/managed_cards/_id_/blockUnblock cards in bulkPOST/bulks/managed_cards/_id_/unblockRemove cards in bulkPOST/bulks/managed_cards/_id_/removeUpdate spend rules for a managed card in bulkPATCH/bulks/managed_cards/_id_/spend_rulesCreate transfer transactions in bulkPOST/bulks/transfersCreate send transactions in bulkPOST/bulks/sendsCreate outgoing wire transfers in bulkPOST/bulks/outgoing_wire_transfersManage
Manage bulk processes that group together multiple operations to be executed asynchronously.
/bulksGet bulk processGET/bulks/{bulk_id}List bulk operationsGET/bulks/{bulk_id}/operationsExecute bulk processPOST/bulks/{bulk_id}/executePause bulk processPOST/bulks/{bulk_id}/pauseResume bulk processPOST/bulks/{bulk_id}/resumeCancel bulk processPOST/bulks/{bulk_id}/cancelManual transactionWebhook/manual_transactions/watchBulk process progressWebhook/bulk_process_end/watchSystem-managed cards
Manage cards created and controlled by the platform.
Roles
Retrieve the roles available to users of an identity.