stripe-android icon indicating copy to clipboard operation
stripe-android copied to clipboard

[BUG] Wrong title "Front of identity card"

Open googol7 opened this issue 1 year ago • 5 comments

Summary

We only accept driving licences but in the interface users get confused because the headers are "Front of identity card" and "Back of identity card".

In German this translates to "Vorderseite des Personalausweises" which is not a driving license.

See also:

  • https://github.com/stripe/stripe-ios/issues/3597

Version

The problem occurs with stripe-android v20.44.0

Details

We currently only accept driver's licences by defining options.document.allowed_types = ["driving_license"] when using the API

Available options are:

  • driving_license ... Drivers license document type.
  • id_card ... ID card document type.
  • passport ... Passport document type.

The optimal solution would be that the title corresponds exactly with options.document.allowed_types. This is how the web version already does it.

Example:

options.document.allowed_types string used
["driving_license"] <string name="stripe_front_of_dl">Front of driver\'s license</string>
["id_card"] <string name="stripe_front_of_id">Front of identity card</string>
["passport"] <string name="stripe_passport">Passport</string>
["driving_license", "id_card", "passport"] <string name="stripe_front_of_id_document">Front of identity document</string>

But in the interface the title is always "Front of identity card" (stripe_front_of_id)

The text is stripe_position_id_front: "Position your identity card in the centre of the frame".

In the code you only use stripe_front_of_id here.

The strings stripe_front_of_dl "Front of driving licence" and "Back of driving licence" (stripe_back_of_dl) are defined but not used in the code.

Android Native - English 2


On the first screen you use: "Get ready to scan your photo ID" which is defined here.

Android Native - English 1

googol7 avatar May 22 '24 12:05 googol7

@ccen-stripe I've seen that the problem seems to be solved on iOS but not yet on Android.

googol7 avatar Jul 08 '24 08:07 googol7

@ccen-stripe In the web version it explicitly says "driver’s licencse" if that is the only document that’s accepted. It would be perfect if the SDK would also do it like this:

  1. Get ready to scan your driver's license Grab your driver's license
  2. Front of driver's license
  3. Flip your ID over Get ready to scan the back of your ID
  4. Back of driver's license

0 1 2 3 4

googol7 avatar Jul 22 '24 12:07 googol7

I've seen that with this commit in the PR

  • https://github.com/stripe/stripe-android/pull/8671

these new translations were added:

<string name="stripe_front_of_id_document">Front of identity document</string>
<string name="stripe_back_of_id_document">Back of identity document</string>

but they are not used in the code yet.

googol7 avatar Sep 04 '24 19:09 googol7

Would be great to have that one fixed soon!

dbartenstein avatar Sep 18 '24 19:09 dbartenstein

Would be awesome if this gets fixed!

LucaB01 avatar Sep 19 '24 12:09 LucaB01

Hi! Working on this now in https://github.com/stripe/stripe-android/pull/9829

kentwilliams-stripe avatar Dec 24 '24 22:12 kentwilliams-stripe

Hi! Working on this now in #9829

Great to hear!

dbartenstein avatar Dec 27 '24 08:12 dbartenstein

Hi! Working on this now in #9829

Thanks @kentwilliams-stripe !

googol7 avatar Dec 27 '24 10:12 googol7

Fixed in https://github.com/stripe/stripe-android/pull/9829

All references to "identity card" should now say "identity document" ✅

kentwilliams-stripe avatar Jan 07 '25 18:01 kentwilliams-stripe

@kentwilliams-stripe Thank you very much!

The web version of the Stripe checkout page goes a step further. The title corresponds exactly with options.document.allowed_types.

Can you imagine doing it the same way? That would be greatly appreciated as it would make it perfectly clear for the users what they are required to do.

googol7 avatar Jan 08 '25 09:01 googol7

@googol7 Thanks for the suggestion, I've added it to our backlog! If this specific behavior is critical for your business use case, you can use a webview with verify.stripe.com instead of the mobile SDK.

kentwilliams-stripe avatar Jan 09 '25 22:01 kentwilliams-stripe

@kentwilliams-stripe Thanks!

We use react-native-webview and there, verify.stripe.com is too slow when accessing the camera. It gets so slow that users can't scan their documents - especially on smartphones that are a bit older or whose CPUs aren't the fastest.

googol7 avatar Jan 10 '25 09:01 googol7

I've noted this, thank you for the feedback!

kentwilliams-stripe avatar Jan 10 '25 19:01 kentwilliams-stripe