Below are the languages and their abbreviations available in OneSpan Sign:
  • English(en)
  • Danish(da)
  • German(de)
  • Spanish(es)
  • French(fr)
  • Italian(it)
  • Dutch(nl)
  • Portuguese(pt)
  • Polish(ru)
  • Chinese Simplified(zh-CN)
  • Chinese Traditional(zh-TW)
  • Japanese(ja)
  • Korean(ko)
  • Greek(el)

Package Level

The sample Java code below shows you how to edit the DocumentPackage object in order to change the package/transaction language:
DocumentPackage pkg = PackageBuilder.newPackageNamed("Example Package " + System.currentTimeMillis())
        .withLanguage(Locale.FRENCH)
        ......
        .build();
Note that the language is on a package/transaction level. The language will be changed for all signers/recipients involved in the transaction.

Signer Level

Similarly, you can specify different languages in signer level. Below is an example on how to build your Signer object with language setting: Note that signer level setting will overwrite the package level language setting.
Signer signer2 = SignerBuilder.newSignerWithEmail("[email protected]")
        .withLanguage(Locale.FRENCH)
        ......
        .build();

The Code

Here’s an example showing you how to build a package with both package and signer level language setting.
DocumentPackage superDuperPackage = PackageBuilder.newPackageNamed("Package Language Example")
                .describedAs("This is a package created using the OneSpan Sign SDK")
                .withLanguage(Locale.ENGLISH)
                .withSigner(SignerBuilder.newSignerWithEmail("[email protected]")
                        .withFirstName("John")
                        .withLastName("Smith")
                        .withTitle("Managing Director")
                        .withCompany("ABC Bank"))
                .withSigner(SignerBuilder.newSignerWithEmail("[email protected]")
                        .withFirstName("Mary")
                        .withLastName("Doe")
                        .withTitle("Applicant")
                        .withCompany("Acme Inc.")
                        .withLanguage(Locale.ENGLISH)
                          )
                .withDocument(DocumentBuilder.newDocumentWithName("First Document")
                        .fromFile("your_file_path")
                        .withSignature(SignatureBuilder.signatureFor("[email protected]")
                                .onPage(0)
                                .atPosition(100, 100))
                        .withSignature(SignatureBuilder.signatureFor("[email protected]")
                                .onPage(0)
                                .atPosition(200, 100)))
                .build();

Get the Code

Below are the languages and their abbreviations available in OneSpan Sign:
  • English(en)
  • Danish(da)
  • German(de)
  • Spanish(es)
  • French(fr)
  • Italian(it)
  • Dutch(nl)
  • Portuguese(pt)
  • Polish(ru)
  • Chinese Simplified(zh-CN)
  • Chinese Traditional(zh-TW)
  • Japanese(ja)
  • Korean(ko)
  • Greek(el)

Package Level

The sample C# code below shows you how to edit the DocumentPackage object in order to change the package/transaction language:
DocumentPackage pkg = PackageBuilder.NewPackageNamed("Example Package " + System.DateTime.Now)
        .WithLanguage("fr")
        ......
        .Build();
Note that the language is on a package/transaction level. The language will be changed for all signers/recipients involved in the transaction.

Signer Level

Similarly, you can specify different languages in signer level. Below is an example on how to build your Signer object with language setting: Note that signer level setting will overwrite the package level language setting.
Signer signer2 = SignerBuilder.NewSignerWithEmail("[email protected]")
        .WithLanguage("fr")
        ......
        .Build();

The Code

The sample C# code below shows you how to edit the DocumentPackage object in order to change the package/transaction language:
DocumentPackage superDuperPackage = PackageBuilder.NewPackageNamed("Package Language Example")
                   .DescribedAs("This is a package created using the OneSpan Sign SDK")
                   .WithLanguage("en")
                   .ExpiresOn(DateTime.Now.AddMonths(1))
                   .WithEmailMessage("This message should be delivered to all signers")
                   .withSigner(SignerBuilder.NewSignerWithEmail("[email protected]")
                        .WithFirstName("John")
                        .WithLastName("Smith")
                        .WithTitle("Managing Director")
                        .WithCompany("ABC Bank"))
                   .withSigner(SignerBuilder.NewSignerWithEmail("[email protected]")
                        .WithFirstName("Mary")
                        .WithLastName("Doe")
                        .WithTitle("Applicant")
                        .WithCompany("Acme Inc.")
                        .WithLanguage("fr")
                          )
                   .WithDocument(DocumentBuilder.NewDocumentNamed("First Document")
                                 .FromFile("your_file_path")
                                 .WithSignature(SignatureBuilder.SignatureFor("[email protected]")
                                 .OnPage(0)
                                 .AtPosition(100, 100))                              
                                 .WithSignature(SignatureBuilder.SignatureFor("[email protected]")
                                 .OnPage(0)
                                 .AtPosition(200, 100)))
                   .Build();

Get the Code

Below are the languages and their abbreviations available in OneSpan Sign:
  • English(en)
  • Danish(da)
  • German(de)
  • Spanish(es)
  • French(fr)
  • Italian(it)
  • Dutch(nl)
  • Portuguese(pt)
  • Polish(ru)
  • Chinese Simplified(zh-CN)
  • Chinese Traditional(zh-TW)
  • Japanese(ja)
  • Korean(ko)
  • Greek(el)

The Code

The request below shows you how to build your JSON payload in order to change the package/transaction as well as signer level language settings:

HTTP Request

POST /api/packages

HTTP Headers

Accept: application/json Content-Type: multipart/form-data Authorization: Basic api_key

Request Payload

------WebKitFormBoundary1bNO60n7FqP5WO4t
Content-Disposition: form-data; name="file"; filename="testDocumentExtraction.pdf"
Content-Type: application/pdf
%PDF-1.5
%µµµµ
1 0 obj
<>>>
endobj.... 
------WebKitFormBoundary1bNO60n7FqP5WO4t
Content-Disposition: form-data; name="payload"
{
  "status": "DRAFT",
  "language": "fr",
  "roles": [
    {
      "id": "Signer1",
      "type": "SIGNER",
      "signers": [
        {
          "id": "Signer1",
          "firstName": "John",
          "lastName": "Smith",
          "email": "[email protected]"
        }
      ],
      "name": "Signer1"
    },
    {
      "id": "Signer2",
      "type": "SIGNER",
      "signers": [
        {
          "id": "Signer2",
          "firstName": "Mary",
          "lastName": "Doe",
          "email": "[email protected]",
          "language": "en"
        }
      ],
      "name": "Signer1"
    }
  ],
  "type": "PACKAGE",
  "name": "Example Package"
}
------WebKitFormBoundary1bNO60n7FqP5WO4t--

For a complete description of each field, take a look at the Request Payload section below.

Response Payload

{
    "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI="
}
Note that the language is on a package/transaction level. The language will be changed for all signers/recipients involved in the transaction.

Get the Code

Request Payload

PropertyTypeEditableRequiredDefaultSample Value(s)
statusstringYesNoDRAFTDRAFT / SENT / COMPLETED / ARCHIVED / DECLINED / OPTED_OUT / EXPIRED
languagestringYesNoenen / fr / es ...
typestringYesNoPACKAGEPACKAGE / TEMPLATE / LAYOUT
namestringYesNon/aExample Package
roles
idstringYesNon/aSigner1
typestringYesNoSIGNERSIGNER / SENDER
namestringYesNon/aSigner1
signers
emailstringYesYesn/a[email protected]
firstNamestringYesYesn/aJohn
lastNamestringYesYesn/aSmith
idstringYesNon/aSigner1
languagestringYesNoenen / fr / es ...
Below are the languages and their abbreviations available in OneSpan Sign:
  • English(en)
  • Danish(da)
  • German(de)
  • Spanish(es)
  • French(fr)
  • Italian(it)
  • Dutch(nl)
  • Portuguese(pt)
  • Polish(ru)
  • Chinese Simplified(zh-CN)
  • Chinese Traditional(zh-TW)
  • Japanese(ja)
  • Korean(ko)
  • Greek(el)

The Code

The sample Apex code below shows you how to edit the Package_x object in order to change the package/transaction language:
ESignLiveSDK sdk = new ESignLiveSDK();
         
//Create package
ESignLiveAPIObjects.Package_x pkg = new ESignLiveAPIObjects.Package_x();
pkg.name = 'Test Configure Package Language - ' + Datetime.now().format();
pkg.status = ESignLiveAPIObjects.PackageStatus.DRAFT;
pkg.language = 'fr';		//configure package language
String packageId = sdk.createPackage(pkg);
System.debug('PackageId: ' + packageId);
Note that the language is on a package/transaction level. The language will be changed for all signers/recipients involved in the transaction.

Get the Code