Skip to content

feat: dispatch card verification events and copy in tokenize-only che… #278

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jakubjasinsky merged 2 commits into from
Aug 18, 2026
Merged

feat: dispatch card verification events and copy in tokenize-only che… #278

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3162d87
feat: dispatch card verification events and copy in tokenize-only che…
jakubjasinsky Aug 10, 2026
bd4f8f4
bump version
jakubjasinsky Aug 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "processout.js",
"version": "1.9.10",
"version": "1.9.11",
"description": "ProcessOut.js is a JavaScript library for ProcessOut's payment processing API.",
"scripts": {
"build:processout": "tsc -p src/processout && uglifyjs --compress --keep-fnames --ie8 dist/processout.js -o dist/processout.js",
Expand Down
12 changes: 12 additions & 0 deletions src/dynamic-checkout/config/payment-config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,18 @@ module ProcessOut {
this.invoiceDetails = invoiceDetails
}

// Tokenize-only is exposed per payment method by the API, but it describes the whole
// checkout: the shopper is verifying a card, not paying for the invoice.
public isTokenizeOnly(): boolean {

@tomasz-pazdziurek-cko tomasz-pazdziurek-cko Aug 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: I can see it's specifically related to card tokenization only. Should we also explicitly mention card in the method's name? As far as I understand, this config can be either card or apm?
In the future, we could even consider creating a union type to explicitly decouple APM and card payments?

@jakubjasinsky jakubjasinsky Aug 18, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The config here is checkout-wide rather than per-method, and isTokenizeOnly() describes the whole session ("this checkout verifies a card, it doesn't pay the invoice") — that's why the comment above it calls that out. The card.tokenize_only lookup is just where the API surfaces the flag. Adding "card" to the name would read as if it only affects the card method, but callers use it to change checkout-wide behavior (e.g. hiding saved payment methods). Happy to revisit as part of a card/APM config split later — agreed that'd be a nice cleanup.

if (!this.invoiceDetails || !this.invoiceDetails.payment_methods) {
return false
}

return this.invoiceDetails.payment_methods.some(
paymentMethod => paymentMethod.card && paymentMethod.card.tokenize_only,
)
}

public getAdditionalDataForGateway(gatewayName: string): Record<string, string> {
return this.additionalData[gatewayName] || {}
}
Expand Down
13 changes: 9 additions & 4 deletions src/dynamic-checkout/dynamic-checkout.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ module ProcessOut {
new DynamicCheckoutPaymentErrorView(
this.processOutInstance,
this.paymentConfig,
Translations.getText("payment-error-generic-message", this.paymentConfig.locale),
getStatusMessage("payment-error-generic-message", this.paymentConfig),
).element,
)

Expand All @@ -106,12 +106,16 @@ module ProcessOut {
)
}

// Set before the status check below so the error view and event know whether this
// checkout is a tokenize-only (card verification) one.
this.paymentConfig.setInvoiceDetails(data.invoice)

if (data.invoice.transaction.status !== "waiting") {
this.loadView(
new DynamicCheckoutPaymentErrorView(
this.processOutInstance,
this.paymentConfig,
Translations.getText("payment-error-generic-message", this.paymentConfig.locale),
getStatusMessage("payment-error-generic-message", this.paymentConfig),
).element,
)

Expand All @@ -125,11 +129,12 @@ module ProcessOut {
undefined,
undefined,
data.invoice.return_url || null,
undefined,
undefined,
this.paymentConfig.isTokenizeOnly(),
)
}

this.paymentConfig.setInvoiceDetails(data.invoice)

this.loadDynamicCheckoutView()
}

Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/ar.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,13 @@ module ProcessOut {
"payment-info-message": "نقوم بمعالجة عملية الدفع الخاصة بك. يمكنك الآن إغلاق هذه النافذة.",
"payment-pending-message": "عملية الدفع الخاصة بك قيد الانتظار.",
"payment-error-generic-message": "لم نتمكن من معالجة عملية الدفع الخاصة بك.",
"verification-success-message": "اكتملت عملية التحقق هذه.",
"verification-cancelled-message": "تم إلغاء عملية التحقق.",
"verification-info-message":
"نقوم بمعالجة عملية التحقق الخاصة بك. يمكنك الآن إغلاق هذه النافذة.",
"verification-pending-message": "عملية التحقق الخاصة بك قيد الانتظار.",
"verification-error-generic-message": "لم نتمكن من التحقق من بطاقتك.",
"processing-verification-label": "جارٍ معالجة التحقق",
"street1-label": "العنوان السطر 1",
"street2-label": "العنوان السطر 2",
"city-label": "المدينة",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/de.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,13 @@ module ProcessOut {
"Wir verarbeiten Ihre Zahlung. Sie können dieses Fenster jetzt schließen.",
"payment-pending-message": "Ihre Zahlung steht noch aus.",
"payment-error-generic-message": "Wir konnten Ihre Zahlung nicht verarbeiten.",
"verification-success-message": "Diese Verifizierung wurde abgeschlossen.",
"verification-cancelled-message": "Die Verifizierung wurde abgebrochen.",
"verification-info-message":
"Wir verarbeiten Ihre Verifizierung. Sie können dieses Fenster jetzt schließen.",
"verification-pending-message": "Ihre Verifizierung steht noch aus.",
"verification-error-generic-message": "Wir konnten Ihre Karte nicht verifizieren.",
"processing-verification-label": "Verifizierung wird verarbeitet",
"street1-label": "Adresszeile 1",
"street2-label": "Adresszeile 2",
"city-label": "Stadt",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/en.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,13 @@ module ProcessOut {
"payment-info-message": "We are processing your payment. You can now close this window.",
"payment-pending-message": "Your payment is pending.",
"payment-error-generic-message": "We were unable to process your payment.",
"verification-success-message": "This verification is completed.",
"verification-cancelled-message": "Verification has been cancelled.",
"verification-info-message":
"We are processing your verification. You can now close this window.",
"verification-pending-message": "Your verification is pending.",
"verification-error-generic-message": "We were unable to verify your card.",
"processing-verification-label": "Processing verification",
"street1-label": "Address line 1",
"street2-label": "Address line 2",
"city-label": "City",
Expand Down
6 changes: 6 additions & 0 deletions src/dynamic-checkout/locales/es.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ module ProcessOut {
"payment-info-message": "Estamos procesando su pago. Puede cerrar esta ventana.",
"payment-pending-message": "Su pago está pendiente.",
"payment-error-generic-message": "No pudimos procesar su pago.",
"verification-success-message": "Esta verificación se ha completado.",
"verification-cancelled-message": "La verificación ha sido cancelada.",
"verification-info-message": "Estamos procesando su verificación. Puede cerrar esta ventana.",
"verification-pending-message": "Su verificación está pendiente.",
"verification-error-generic-message": "No pudimos verificar su tarjeta.",
"processing-verification-label": "Procesando verificación",
"street1-label": "Dirección, línea 1",
"street2-label": "Dirección, línea 2",
"city-label": "Ciudad",
Expand Down
6 changes: 6 additions & 0 deletions src/dynamic-checkout/locales/fi.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ module ProcessOut {
"payment-info-message": "Käsittelemme maksuasi. Voit nyt sulkea tämän ikkunan.",
"payment-pending-message": "Maksusi on käsittelyssä.",
"payment-error-generic-message": "Maksuasi ei voitu käsitellä.",
"verification-success-message": "Tämä vahvistus on suoritettu.",
"verification-cancelled-message": "Vahvistus on peruutettu.",
"verification-info-message": "Käsittelemme vahvistustasi. Voit nyt sulkea tämän ikkunan.",
"verification-pending-message": "Vahvistuksesi on käsittelyssä.",
"verification-error-generic-message": "Korttiasi ei voitu vahvistaa.",
"processing-verification-label": "Käsitellään vahvistusta",
"street1-label": "Osoiterivi 1",
"street2-label": "Osoiterivi 2",
"city-label": "Kaupunki",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/fr.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,13 @@ module ProcessOut {
"Nous travaillons sur votre paiement. Vous pouvez maintenant fermer cette fenêtre.",
"payment-pending-message": "Votre paiement est en attente.",
"payment-error-generic-message": "Nous n'avons pas pu traiter votre paiement.",
"verification-success-message": "Cette vérification a été effectuée avec succès.",
"verification-cancelled-message": "La vérification a été annulée.",
"verification-info-message":
"Nous travaillons sur votre vérification. Vous pouvez maintenant fermer cette fenêtre.",
"verification-pending-message": "Votre vérification est en attente.",
"verification-error-generic-message": "Nous n'avons pas pu vérifier votre carte.",
"processing-verification-label": "Traitement de la vérification",
"street1-label": "Adresse, ligne 1",
"street2-label": "Adresse, ligne 2",
"city-label": "Ville",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/it.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,13 @@ module ProcessOut {
"Stiamo elaborando il tuo pagamento. Ora puoi chiudere questa finestra.",
"payment-pending-message": "Il tuo pagamento è in sospeso.",
"payment-error-generic-message": "Non è stato possibile elaborare il pagamento.",
"verification-success-message": "La verifica è stata completata.",
"verification-cancelled-message": "La verifica è stata annullata.",
"verification-info-message":
"Stiamo elaborando la tua verifica. Ora puoi chiudere questa finestra.",
"verification-pending-message": "La tua verifica è in sospeso.",
"verification-error-generic-message": "Non è stato possibile verificare la carta.",
"processing-verification-label": "Elaborazione della verifica",
"street1-label": "Indirizzo riga 1",
"street2-label": "Indirizzo riga 2",
"city-label": "Città",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/ja.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,13 @@ module ProcessOut {
"お支払いを処理しています。このウィンドウを閉じていただいて構いません。",
"payment-pending-message": "お支払いは保留中です。",
"payment-error-generic-message": "お支払いを処理できませんでした。",
"verification-success-message": "確認が完了しました。",
"verification-cancelled-message": "確認がキャンセルされました。",
"verification-info-message":
"確認を処理しています。このウィンドウを閉じていただいて構いません。",
"verification-pending-message": "確認は保留中です。",
"verification-error-generic-message": "カードを確認できませんでした。",
"processing-verification-label": "確認を処理中",
"street1-label": "住所1",
"street2-label": "住所2",
"city-label": "市区町村",
Expand Down
6 changes: 6 additions & 0 deletions src/dynamic-checkout/locales/ko.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ module ProcessOut {
"payment-info-message": "결제를 처리하고 있습니다. 이 창을 닫으셔도 됩니다.",
"payment-pending-message": "결제가 대기 중입니다.",
"payment-error-generic-message": "결제를 처리할 수 없습니다.",
"verification-success-message": "인증이 완료되었습니다.",
"verification-cancelled-message": "인증이 취소되었습니다.",
"verification-info-message": "인증을 처리하고 있습니다. 이 창을 닫으셔도 됩니다.",
"verification-pending-message": "인증이 대기 중입니다.",
"verification-error-generic-message": "카드를 인증할 수 없습니다.",
"processing-verification-label": "인증 처리 중",
"street1-label": "주소 1",
"street2-label": "주소 2",
"city-label": "시/군/구",
Expand Down
6 changes: 6 additions & 0 deletions src/dynamic-checkout/locales/nb.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ module ProcessOut {
"payment-info-message": "Vi behandler betalingen din. Du kan nå lukke dette vinduet.",
"payment-pending-message": "Betalingen din er under behandling.",
"payment-error-generic-message": "Vi kunne ikke behandle betalingen din.",
"verification-success-message": "Denne verifiseringen er fullført.",
"verification-cancelled-message": "Verifiseringen er kansellert.",
"verification-info-message": "Vi behandler verifiseringen din. Du kan nå lukke dette vinduet.",
"verification-pending-message": "Verifiseringen din er under behandling.",
"verification-error-generic-message": "Vi kunne ikke verifisere kortet ditt.",
"processing-verification-label": "Behandler verifisering",
"street1-label": "Adresselinje 1",
"street2-label": "Adresselinje 2",
"city-label": "By",
Expand Down
6 changes: 6 additions & 0 deletions src/dynamic-checkout/locales/pl.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ module ProcessOut {
"payment-info-message": "Przetwarzamy Twoją płatność. Możesz teraz zamknąć tę okno.",
"payment-pending-message": "Twoja płatność oczekuje na realizację.",
"payment-error-generic-message": "Nie udało nam się przetworzyć Twojej płatności.",
"verification-success-message": "Weryfikacja została zakończona pomyślnie.",
"verification-cancelled-message": "Weryfikacja została anulowana.",
"verification-info-message": "Przetwarzamy Twoją weryfikację. Możesz teraz zamknąć to okno.",
"verification-pending-message": "Twoja weryfikacja jest w toku.",
"verification-error-generic-message": "Nie udało nam się zweryfikować Twojej karty.",
"processing-verification-label": "Przetwarzanie weryfikacji",
"street1-label": "Adres, linia 1",
"street2-label": "Adres, linia 2",
"city-label": "Miasto",
Expand Down
10 changes: 8 additions & 2 deletions src/dynamic-checkout/locales/pt.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,16 @@ module ProcessOut {
"other-payment-methods-header": "Outros métodos de pagamento",
"select-payment-method-label": "Selecionar método de pagamento",
"payment-success-message": "Este pagamento foi concluído.",
"payment-info-message":
"Estamos a processar o seu pagamento. Pode agora fechar esta janela.",
"payment-info-message": "Estamos a processar o seu pagamento. Pode agora fechar esta janela.",
"payment-pending-message": "O seu pagamento está pendente.",
"payment-error-generic-message": "Não foi possível processar o seu pagamento.",
"verification-success-message": "Esta verificação foi concluída.",
"verification-cancelled-message": "A verificação foi cancelada.",
"verification-info-message":
"Estamos a processar a sua verificação. Pode agora fechar esta janela.",
"verification-pending-message": "A sua verificação está pendente.",
"verification-error-generic-message": "Não foi possível verificar o seu cartão.",
"processing-verification-label": "A processar verificação",
"street1-label": "Morada, linha 1",
"street2-label": "Morada, linha 2",
"city-label": "Cidade",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/ta.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,13 @@ module ProcessOut {
"payment-info-message": "உங்கள் கட்டணத்தைச் செயலாக்குகிறோம். இப்போது இந்தச் சாளரத்தை மூடலாம்.",
"payment-pending-message": "உங்கள் கட்டணம் நிலுவையில் உள்ளது.",
"payment-error-generic-message": "உங்கள் கட்டணத்தைச் செயலாக்க முடியவில்லை.",
"verification-success-message": "இந்தச் சரிபார்ப்பு முடிந்தது.",
"verification-cancelled-message": "சரிபார்ப்பு ரத்து செய்யப்பட்டது.",
"verification-info-message":
"உங்கள் சரிபார்ப்பைச் செயலாக்குகிறோம். இப்போது இந்தச் சாளரத்தை மூடலாம்.",
"verification-pending-message": "உங்கள் சரிபார்ப்பு நிலுவையில் உள்ளது.",
"verification-error-generic-message": "உங்கள் அட்டையைச் சரிபார்க்க முடியவில்லை.",
"processing-verification-label": "சரிபார்ப்பு செயலாக்கப்படுகிறது",
"street1-label": "முகவரி வரி 1",
"street2-label": "முகவரி வரி 2",
"city-label": "நகரம்",
Expand Down
7 changes: 7 additions & 0 deletions src/dynamic-checkout/locales/vi.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,13 @@ module ProcessOut {
"Chúng tôi đang xử lý thanh toán của bạn. Bạn có thể đóng cửa sổ này ngay bây giờ.",
"payment-pending-message": "Thanh toán của bạn đang chờ xử lý.",
"payment-error-generic-message": "Chúng tôi không thể xử lý thanh toán của bạn.",
"verification-success-message": "Xác minh này đã hoàn tất.",
"verification-cancelled-message": "Xác minh đã bị hủy.",
"verification-info-message":
"Chúng tôi đang xử lý xác minh của bạn. Bạn có thể đóng cửa sổ này ngay bây giờ.",
"verification-pending-message": "Xác minh của bạn đang chờ xử lý.",
"verification-error-generic-message": "Chúng tôi không thể xác minh thẻ của bạn.",
"processing-verification-label": "Đang xử lý xác minh",
"street1-label": "Địa chỉ dòng 1",
"street2-label": "Địa chỉ dòng 2",
"city-label": "Thành phố",
Expand Down
Loading
Loading