Yaad Payments
Business Background
Do you want to add payment types to your Web project? You can add YaadPay as one of the options to configure payments into your platform or marketplace and integrate them with Salesforce.
YaadPay offers a comprehensive payment gateway supporting various transaction types, including credit/debit card payments, recurring billing, and tokenized transactions. It caters to both online and in-person payments, providing flexibility for businesses of all sizes. It provides security measures, such as PCI DSS compliance, SSL encryption, and advanced fraud detection systems. These features ensure secure processing of transactions and protection of sensitive customer data.
Titan Solution
To enhance the user experience, add YaadPay as a payment option on your website. You can seamlessly integrate YaadPay with your Salesforce account.
You can add the following:
- Different currencies
- Single payments, installments, or recurring payments
You can configure different actions on payment:
- Send an email
- Redirect the user to another internal or external page
- Push payment data to Salesforce
How to Guide
Prerequisite:
- Click the YaadPay option. The Payment Configuration screen opens.
- Set up the following:
Payment Method
- Use the drop-down list to select a currency. This is a list of the currencies that YaadPay supports. The options are:
- Israeli Shekel (default option)
- Dollars
- Euros
- Pound Sterling
- Dynamic
You can select “Dynamic” to provide a flexible currency, according to what the customer needs.
Add the dynamic value as a variable. Use the following numbers:
- 1 – ILS
- 2 – USD
- 3 – EURO
- 4 – POUND
YaadPay will reject any other values.
- Use a radio button to select the following:
- Single payment. Only a single payment will be deducted.
- Installment. The money due will be deducted as one of several equal payments spread over an agreed period of time.
- Select Static and add the number of installments in the field.
- The number must be larger than 1.
- If necessary, select the Fixed checkbox to ensure that the precise number of installments is deducted.
- If the checkbox is selected, only the specified number of installments can be deducted.
- If the checkbox is not selected, the number of installments that can be deducted can be between 1 and the number specified.
- Select Static and add the number of installments in the field.
- Recurring. Recurring payments will be deducted. The details of these payments are configured on the Processor Configuration screen using the Recurring Settings option.
- Click the Next button. The Payment Configuration > Processor Configuration screen opens.
Processor Configuration
Configure the following as necessary:
- Required processor configuration
- Recurring Settings
- This option is only available when the Recurring radio button on the Payment Method screen is selected.
- Structured parameters
Required
- For Required processor configuration, do the following:
- Add the Terminal Number to the field.
- This is the mandatory 10-digit Masof number.
- Add the Password Authentication.
- This is a mandatory field.
- This allows you to access the page with a visible password without needing authentication.
- As an alternative, select the Sandbox System option.
- The Terminal Number and Password Authentication fields become greyed out.
- The Sandbox System is an isolated virtual machine in which potentially unsafe software code can execute without affecting network resources or local applications. This is a safe way to test the payment integration.
- Select the More callback data checkbox to receive more data from Yaad, for instance, the last four digits of the credit card, the number of payments charged, or the brand of the credit card.
- More Salesforce mapping options will be available if the More callback data checkbox is selected.
- View the Return URL. The URL of the success page contains the parameter that YaadPay uses for the verification.
- The return URL will receive instant payment notifications (IPNs) whenever a successful installment payment is completed.
- Add the Terminal Number to the field.
- Refer to the table for more information:
Label in Titan | Label in API | Type | Remarks |
---|---|---|---|
Terminal Number | Masof | 10 digits | Required |
Password Authentication | PassP | Value from client service | Required |
More callback data | MoreData | Return more data on the transaction | Optional |
Recurring Settings
- Select the Recurring Settings option.
- Use the toggle switch to enable the recurring settings.
- Use the Field or Static options to add parameters.
- Type a Static parameter in the field
- Use the drop-down list to select a Field parameter.
Define a permanent recurring setting using 999 as the number of payments. Otherwise, select any number between 2 and 998 to set up a certain number of payments.
- Select the Only On Approve checkbox to enable the option. The recurring payment will only be executed if it has been approved.
You can filter the parameters. Just type a word or part of a word in the Filter field. You can select to show the following:
- All
- Set
- Not Set
Structured Parameters
- Select the Structured Parameters option.
- Use the toggle switch to enable the structured parameters.
- The Info structured parameter is mandatory.
- This is the text that will be displayed next to each transaction in both the report and the management system.
- Use the Field or Static options to add parameters.
- Type a Static parameter in the field.
- Use the drop-down list to select a Field parameter.
Info is a mandatory parameter.
- Refer to the table for more information:
Label in Titan | Label in API | Type | Remarks |
---|---|---|---|
First Name | ClientName | VarChar | Required |
Last Name | ClientLName | VarChar | Optional |
ID | UserId | You can send 9 zeros if the credit card company doesn’t require the ID | It is recommended that the customer fill this field on the payment page without having to send it. If a request is submitted to open a template in English, UserId = 000000000 or UserId = L Customer number must be sent. This parameter appears on the invoice in the default format. |
Invoice Description | heshDesc | Text/ Number or items values | Optional |
Street | street | VarChar | Optional |
City | city | VarChar | Optional |
Zip Code | zip | VarChar | Optional |
Phone | phone | Number | Optional |
Cellular | cell | Number | Optional |
Send invoice by SMS | sendHeshSMS | Checkbox | True or False. It will be displayed if cell was filled. |
Optional | |||
Send invoice in mail | SendHesh | Checkbox | True or False. It will be displayed if email was filled. |
- Click the Next button. The Payment Configuration > Layout screen opens.
Layout
- Add a label in the field.
- This is mandatory.
- This description will appear on the Configure Project Payments Settings screen under the My Payments list.
- Use the drop-down list to select the total amount.
- This is mandatory.
- You must have added the amount to your project as an input element or variable.
- Use the drop-down list to select the payment page language.
- This is either Hebrew or English.
- Use the drop-down list to select the payment page template.
- Select a number between 1 and 15.
- Refer to YaadPay documentation for more information about available YaadPay’s payment templates.
- Click the Next button. The Payment Configuration > Post Payment screen opens.
Post Payment
You can do the following:
- Send an email.
- Redirect the user to an internal and/or external link when payment processing is finished.
- Redirect the user to an internal and/or external link when payment processing fails.
- To send an email, use the toggle switch to switch on the option.
- You can configure an email that will be sent when the transaction has been processed.
- Select the configured email.
- Select the Redirect on Finish option, if necessary
- Use the toggle switch to switch on a redirect action on finish action.
- Configure an External redirection.
- Configure an Internal redirection.
- Select the Redirect on Failure option, if necessary
- Use the toggle switch to switch on a redirect action on failure action.
- Click the Next button. The Payment Configuration > SF Integration opens.