Documentation
Knowledge baseContact

Translations

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

Example:

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

Above you can see Cardholder name is missing a default translation, if we hit nl_NL or en_GB locales we do resolve to those, cause those are set. But if we now go to fr_FR and we don't have a translation underneath translations and not a default, it will fall back to the pay.nl translation (In French).

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."
      }
    }
  }
}