Translations

You can configure custom texts for the PayParts components. The structure has fallbacks too: if you don't provide all translations yourself it will by default fall back to the pay.nl default translations.

📘

Fallback behavior

In the example below, Cardholder name is missing a default translation. If we hit nl_NL or en_GB locales we do resolve to those, because they are set. But if we now go to fr_FR and we don't have a translation underneath translations and no default, it will fall back to the pay.nl translation (in French).

Example:

{
  "creditCard": {
    "labels": {
      "cardNumber": "Card number",
      "expiryDate": "Expiry date",
      "cvc": "CVC",
      "translations": {
        "cardHolderName": {
          "nl_NL": "Kaarthouder naam",
          "en_GB": "Cardholder name"
        },
        "cardNumber": {
          "nl_NL": "Kaartnummer"
        }
      }
    }
  }
}
Full default translation file

Here is our full default translation file:

{
  "creditCard": {
    "labels": {
      "cardHolderName": "Cardholder name",
      "cardNumber": "Card number",
      "expiryDate": "Expiry date",
      "cvc": "CVC",
      "translations": {
        "cardHolderName": {
          "nl_NL": "Kaarthouder naam",
          "en_GB": "Cardholder name",
          "de_DE": "Karteninhaber",
          "fr_FR": "Autres ventes aux consommateurs"
        },
        "cardNumber": {
          "en_GB": "Card number",
          "nl_NL": "Kaartnummer",
          "be_BE": "Kaartnummer",
          "de_DE": "Kartennummer",
          "fr_FR": "Numéro de carte"
        },
        "expiryDate": {
          "en_GB": "Expiry date",
          "nl_NL": "Vervaldatum",
          "be_BE": "Vervaldatum",
          "de_DE": "Ablaufdatum",
          "fr_FR": "Date d'expiration"
        },
        "cvc": {
          "en_GB": "CVC",
          "nl_NL": "CVC",
          "be_BE": "CVC",
          "de_DE": "CVC",
          "fr_FR": "CVC"
        }
      }
    },
    "placeholders": {
      "cardholderName": "Full name on card",
      "cardNumber": "1234 5678 9012 3456",
      "expiryDate": "MM / YY",
      "cvc": "CVC",
      "translations": {
        "cardholderName": {
          "en_GB": "Full name on card",
          "nl_NL": "Volledige naam op kaart",
          "be_BE": "Volledige naam op kaart",
          "de_DE": "Vollständiger Name",
          "fr_FR": "Nom complet sur la carte"
        },
        "cardNumber": {
          "en_GB": "1234 5678 9012 3456",
          "nl_NL": "1234 5678 9012 3456",
          "be_BE": "1234 5678 9012 3456",
          "de_DE": "1234 5678 9012 3456",
          "fr_FR": "1234 5678 9012 3456"
        },
        "expiryDate": {
          "en_GB": "MM / YY",
          "nl_NL": "MM / JJ",
          "be_BE": "MM / JJ",
          "de_DE": "MM / JJ",
          "fr_FR": "MM / AA"
        },
        "cvc": {
          "en_GB": "CVC",
          "nl_NL": "CVC",
          "be_BE": "CVC",
          "de_DE": "CVC",
          "fr_FR": "CVC"
        }
      }
    },
    "required": "required",
    "translations": {
      "required": {
        "en_GB": "required",
        "nl_NL": "verplicht",
        "be_BE": "verplicht",
        "de_DE": "erforderlich",
        "fr_FR": "requis"
      }
    },
    "button": {
      "pay": "Pay",
      "translations": {
        "pay": {
          "en_GB": "Pay",
          "nl_NL": "Betaling",
          "be_BE": "Betaling",
          "de_DE": "Zahlen",
          "fr_FR": "Payer"
        }
      }
    },
    "errors": {
      "required": "{{field}} is required",
      "requiredMultiple": "Please fill in: {{fields}}",
      "fillRequiredFields": "Please fill in all required fields",
      "correctErrors": "Please correct the errors",
      "paymentFailed": "Payment failed",
      "invalidExpiryMonth": "Invalid expiry month",
      "cardExpired": "Card has expired",
      "invalidCardNumber": "Invalid card number",
      "invalidCardLength": "Invalid card number",
      "invalidCvc": "Invalid CVC",
      "translations": {
        "required": {
          "en_GB": "{{field}} is required",
          "nl_NL": "{{field}} is verplicht",
          "be_BE": "{{field}} is verplicht",
          "de_DE": "{{field}} ist erforderlich",
          "fr_FR": "{{field}} est requis"
        },
        "requiredMultiple": {
          "en_GB": "Please fill in: {{fields}}",
          "nl_NL": "Vul a.u.b. in: {{fields}}",
          "be_BE": "Vul a.u.b. in: {{fields}}",
          "de_DE": "Bitte ausfüllen: {{fields}}",
          "fr_FR": "Veuillez remplir: {{fields}}"
        },
        "fillRequiredFields": {
          "en_GB": "Please fill in all required fields",
          "nl_NL": "Vul alle verplichte velden in",
          "be_BE": "Vul alle verplichte velden in",
          "de_DE": "Bitte füllen Sie alle erforderlichen Felder aus",
          "fr_FR": "Veuillez remplir tous les champs obligatoires"
        },
        "correctErrors": {
          "en_GB": "Please correct the errors",
          "nl_NL": "Corrigeer de fouten",
          "be_BE": "Corrigeer de fouten",
          "de_DE": "Bitte korrigieren Sie die Fehler",
          "fr_FR": "Veuillez corriger les erreurs"
        },
        "paymentFailed": {
          "en_GB": "Payment failed",
          "nl_NL": "Betaling mislukt",
          "be_BE": "Betaling mislukt",
          "de_DE": "Zahlung fehlgeschlagen",
          "fr_FR": "Paiement échoué"
        },
        "invalidExpiryMonth": {
          "en_GB": "Invalid expiry month",
          "nl_NL": "Ongeldige maand",
          "be_BE": "Ongeldige maand",
          "de_DE": "Ungültiger Monat",
          "fr_FR": "Mois invalide"
        },
        "cardExpired": {
          "en_GB": "Card has expired",
          "nl_NL": "Kaart verlopen",
          "be_BE": "Kaart verlopen",
          "de_DE": "Karte abgelaufen",
          "fr_FR": "Carte expirée"
        },
        "invalidCardNumber": {
          "en_GB": "Invalid card number",
          "nl_NL": "Ongeldig kaartnummer",
          "be_BE": "Ongeldig kaartnummer",
          "de_DE": "Ungültige Kartennummer",
          "fr_FR": "Numéro de carte invalide"
        },
        "invalidCardLength": {
          "en_GB": "Invalid card number",
          "nl_NL": "Ongeldig kaartnummer",
          "be_BE": "Ongeldig kaartnummer",
          "de_DE": "Ungültige Kartennummer",
          "fr_FR": "Numéro de carte invalide"
        },
        "invalidCvc": {
          "en_GB": "Invalid CVC",
          "nl_NL": "Ongeldige CVC",
          "be_BE": "Ongeldige CVC",
          "de_DE": "Ungültige CVC",
          "fr_FR": "CVC invalide"
        }
      }
    }
  },
  "methods": {
    "expansionText": "{{count}} more payment methods",
    "translations": {
      "expansionText": {
        "en_GB": "{{count}} more payment methods",
        "nl_NL": "Toon nog {{count}} betaalmethoden",
        "be_BE": "{{count}} overige betaalopties",
        "de_DE": "{{count}} weitere Zahlungsmethoden",
        "fr_FR": "{{count}} autres moyens de paiement"
      }
    }
  },
  "errors": {
    "cardNotAccepted": "Unable to complete payment with this card. Please contact your bank or card issuer for more information.",
    "translations": {
      "cardNotAccepted": {
        "en_GB": "Unable to complete payment with this card. Please contact your bank or card issuer for more information.",
        "nl_NL": "Het is helaas niet mogelijk om de betaling te voltooien met deze kaart. Raadpleeg uw bank of kaartuitgever voor meer informatie.",
        "be_BE": "Het is helaas niet mogelijk om de betaling te voltooien met deze kaart. Raadpleeg uw bank of kaartuitgever voor meer informatie.",
        "de_DE": "Die Zahlung mit dieser Karte kann nicht abgeschlossen werden. Bitte wenden Sie sich an Ihre Bank oder Kartenherausgeber für weitere Informationen.",
        "fr_FR": "Le paiement avec cette carte ne peut pas être terminé. Veuillez contacter votre banque ou l'émetteur de la carte pour plus d'informations."
      }
    }
  }
}

Did this page help you?