Skip to content

v3.2
Compare
Choose a tag to compare
@millin-stripe millin-stripe released this 07 Jun 13:43
· 31 commits to master since this release
v3.2
dbae8b2
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Release Notes - Version 3.2.0

New Feature: KYC Monitor and Seller Update Job

Overview

With the introduction of this feature, we are adding a new job that monitors the Know Your Customer (KYC) status of sellers' connect accounts. This development is intended to address issues that arise when there's a further requirement for document verification at Stripe, resulting in the seller's connect account being flagged as "KYC required". This status could impede the account from receiving further payments via API.

Problem Addressed

Previously, the connector jobs payment transfer required KYC-enabled connect accounts for successful execution. If Stripe flagged a connect account as "KYC required", any payment transfer against that account would fail. This issue often resulted in continuous retries and failures on the connector side.

Solution Implemented

The new job checks the KYC status of connect accounts and flags any account requiring KYC as "ignored". If the Mirakl update for KYC disablement is configured as true, it updates the relevant Mirakl shop to KYC required status. It will also notify the operator with an email containing a list of accounts that require KYC update.

How to Use

Command to run the new job:

php bin/console connector:dispatch:monitor-kyc-status -q 2>&1

Configuration setting:

KYC_MIRAKL_SHOP_DISABLE_UPDATE=true

Setting this flag to false, or if it's absent in the .env file, will prevent the job from setting the Mirakl shop KYC status to "KYC required" (S07 API call).

Workflow

Here are the high-level steps of execution flow:

  1. Retrieve all associated connect accounts from Stripe using the GET /v1/accounts API call.
  2. Filter the onboarded accounts from the retrieved ones using the connector data.
  3. Check whether any onboarded account requires KYC from the Stripe side.
  4. If KYC is required:
    a. Set the "ignored" flag as true for the KYC required accounts in the connector DB.
    b. If KYC_MIRAKL_SHOP_DISABLE_UPDATE is set as true, call the Mirakl S07 - Patch update shops API to update the corresponding Mirakl shops to KYC required status. The account link is also updated for KYC.
    c. Notify the operator via an email containing details of the KYC required accounts.

This update significantly enhances the efficiency of the payment transfer process and reduces connector job failures. We encourage everyone to update their systems to version 3.2.0 for a smoother and more streamlined experience.

Assets 2
Loading