Viber OTP templates inventory

Predefined one-time password (OTP) templates for Viber verification messages. Use the Template ID and Parameters in your API request when sending an OTP.

Quick reference

Template name	Template ID	Required parameters
Basic OTP	`0aac888f-2ee2-4112-9659-1755a951966a`	`pin`
Basic OTP valid for 5 minutes	`c2cdc028-a48b-4187-bbaf-3aaa137b6e23`	`pin`
OTP with business/platform name	`c33cccaf-735f-4d62-8383-a76bf4999e2d`	`pin`, `businessPlatformName`
OTP with code validity time	`bed0942f-e07e-4879-834b-29cc4cf3ec35`	`pin`, `codeValidityTime` (minutes)
OTP with code type & validity time	`60d67b38-b9fb-444a-80e6-754447e010c6`	`pin`, `pinType`, `codeValidityTime` (minutes)
OTP with business/platform name & validity time	`6c929cef-29b4-4349-bc9d-2a07bdbb6e43`	`pin`, `businessPlatformName`, `codeValidityTime` (minutes)
OTP with type of code	`82ba31a3-db42-4e87-82e8-33fa92b9e5ed`	`pin`, `pinType`
OTP with details on OTP action/platform	`210ee8a9-1ed5-43cd-96e4-65bba311ab40`	`pin`, `businessPlatformActionName`
OTP with business/platform name & code reason	`be56d97b-2a33-4c89-ac5f-f555a2c827d9`	`pin`, `businessPlatformName`, `codeReason`

Parameter names in API requests

Send parameters in camelCase in your request body. Example for template 6:

{
  "templateId": "6c929cef-29b4-4349-bc9d-2a07bdbb6e43",
  "templateParams": {
    "pin": "123456",
    "businessPlatformName": "MyApp",
    "codeValidityTime": 5
  }
}

Template variable	API parameter name
`{{pin}}`	`pin`
`{{pin_type}}`	`pinType`
`{{code_validity_time}}`	`codeValidityTime`
`{{business_platform_name}}`	`businessPlatformName`
`{{business_platform_action_name}}`	`businessPlatformActionName`
`{{code_reason}}`	`codeReason`

1. Basic OTP

Template ID: 0aac888f-2ee2-4112-9659-1755a951966a

Message copy:

Your code is {{pin}}.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user

2. Basic OTP valid for 5 minutes

Template ID: c2cdc028-a48b-4187-bbaf-3aaa137b6e23

Message copy:

Your code is {{pin}}. It's valid for 5 minutes.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user

3. OTP with business/platform name

Template ID: c33cccaf-735f-4d62-8383-a76bf4999e2d

Message copy:

{{business_platform_name}}: Your code is {{pin}}.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`businessPlatformName`	TEXT	Your app or platform name (e.g. "MyBank", "Acme App")

4. OTP with code validity time

Template ID: bed0942f-e07e-4879-834b-29cc4cf3ec35

Message copy:

Your code is {{pin}}. It's valid for {{code_validity_time}} minutes.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`codeValidityTime`	NUMBER	Validity duration in minutes (e.g. `5`, `10`, `15`)

5. OTP with code type & validity time

Template ID: 60d67b38-b9fb-444a-80e6-754447e010c6

Message copy:

Your {{pin_type}} code is {{pin}}. It's valid for {{code_validity_time}} minutes.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`pinType`	TEXT	Type of code (e.g. "verification", "login")
`codeValidityTime`	NUMBER	Validity duration in minutes (e.g. `5`, `10`)

6. OTP with business/platform name & validity time

Template ID: 6c929cef-29b4-4349-bc9d-2a07bdbb6e43

Message copy:

Your {{business_platform_name}} code is {{pin}}. It's valid for {{code_validity_time}} minutes.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`businessPlatformName`	TEXT	Your app or platform name
`codeValidityTime`	NUMBER	Validity duration in minutes (e.g. `5`, `10`, `15`)

7. OTP with type of code

Template ID: 82ba31a3-db42-4e87-82e8-33fa92b9e5ed

Message copy:

Your {{pin_type}} code is {{pin}}.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`pinType`	TEXT	Type of code (e.g. "verification", "login")

8. OTP with details on OTP action/platform

Template ID: 210ee8a9-1ed5-43cd-96e4-65bba311ab40

Message copy:

Your one-time password for {{business_platform_action_name}} is {{pin}}.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`businessPlatformActionName`	TEXT	The action or context (e.g. "logging in", "confirming payment")

9. OTP with business/platform name & code reason

Template ID: be56d97b-2a33-4c89-ac5f-f555a2c827d9

Message copy:

{{business_platform_name}}: Your code is {{pin}}. You got this code because {{code_reason}}.
Please don't share your code with ANYONE. We'll never call or message you and ask for it.

Parameters:

Parameter	Type	Description
`pin`	TEXT	The OTP code shown to the user
`businessPlatformName`	TEXT	Your app or platform name
`codeReason`	TEXT	Reason the user received the code (e.g. "you requested a password reset")