Portfolio Management for Resellers {#sa-portfolio-reseller-mgmt} ================================================================ This section describes how to manage portfolios for your merchants. Reseller: Creating a `Secure Acceptance` Profile {#sa-both-intro-create-sa-profile-reseller} ============================================================================================ Contact `Cybersource` Customer Support to enable your account for `Secure Acceptance`. You must activate a profile in order to use it. See [Activating a Profile](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-activate-profile.md ""). 1. Log in to the Business Center: #### ADDITIONAL INFORMATION * Production: [businesscenter.cybersource.com](https://businesscenter.cybersource.com "") * Production in India: [businesscenter.in.cybersource.com](https://businesscenter.in.cybersource.com "") * Test: [businesscentertest.cybersource.com](https://businesscentertest.cybersource.com "") 2. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Settings. The `Secure Acceptance` Settings page appears. 3. Click New Profile. The Create Profile page appears. 4. Enter or verify these profile details. #### ADDITIONAL INFORMATION | Profile Detail | Description | |-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Profile Name | The `Secure Acceptance` profile name is required and cannot exceed 40 alphanumeric characters. | | Profile Description | The profile description cannot exceed 255 characters. | | Integration Method | Check `Hosted Checkout Integration`. | | Company Name | The company name is required and cannot exceed 40 alphanumeric characters. | | Company Contact Name | Enter company contact information: name, email, and phone number. | | Company Contact Email | Enter company contact information: name, email, and phone number. | | Company Phone Number | Enter company contact information: name, email, and phone number. | | Payment Tokenization | Check Payment Tokenization. For more information, see [Payment Transactions](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-payment-txns.md ""). | | `Decision Manager` | Check `Decision Manager`. For more information, see [Decision Manager](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-custom-fme-dm.md ""). | | Verbose Data | Check Verbose Data. For more information, see [Decision Manager](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-custom-fme-dm.md ""). | | Generate Device Fingerprint | Check Generate Device Fingerprint. For more information, see [Decision Manager](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-custom-fme-dm.md ""). | [Profile Details] 5. Click Submit. Payment Method Configuration {#sa-payment-method-configuration-reseller} ======================================================================== You must configure at least one payment method before you can activate a profile. Visa Click to Pay uses Visa Checkout services and API fields. A payment method selection page is displayed as part of the checkout process for any of these scenarios: * Multiple payment methods are enabled for the profile, and no payment_method field is included in the request. * payment_method=`visacheckout` is included in the request. * `Visa Click to Pay` is the only enabled payment method for the profile. See [Reseller: Configuring Visa Click to Pay](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-portfolio-reseller-mgmt/sa-visa-clicktopay-configuration-reseller/sa-configure-visa-clicktopay-reseller.md ""). You can skip the payment method selection page by specifying card or echeck as the only available payment method. See [Reseller: Enabling ACH Payments](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-portfolio-reseller-mgmt/sa-enable-echecks-reseller.md ""). Customers can change the payment method during the checkout process. Reseller: Adding Card Types and Currencies {#sa-add-card-types-curr-reseller} ============================================================================= For each card type you choose, you can also manage currencies and payer authentication options. Choose only the types of payment cards and currencies that your merchant account provider authorizes. The card verification number (CVN) is a three- or four-digit number that helps ensure that the customer possesses the card at the time of the transaction. > Secure Acceptance does not process transactions for cards that do not have a card verification number (CVN) and expiration date. Most China UnionPay debit and credit cards issued before 2016 do not have a CVN and expiration date. You must decide whether you will require the CVN. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Click Add Card Types. The list of card types appear. 5. Check each card type that you want to offer to the customer as a payment method. Your payment processor must support the card types. 6. Click Settings for each card type. The card settings and currencies lists appear. 7. Check CVN Display to display the CVN field on `Secure Acceptance`. The customer decides whether to enter the CVN. `Cybersource` recommends displaying the CVN to reduce fraud. 8. Check CVN Required. The CVN Display option must also be checked. If this option is checked, the customer is required to enter the CVN. `Cybersource` recommends requiring the CVN to reduce fraud. 9. Check the currencies for each card. #### ADDITIONAL INFORMATION > By default, all currencies are listed as disabled. You must select at least one currency. Contact your merchant account provider for a list of supported currencies. If you select the Elo or Hipercard card type, only the Brazilian Real currency is supported. 10. Click Submit. The card types are added as an accepted payment type. 11. Click Save. Payer Authentication Configuration {#sa-payer-auth-configuration-reseller} ========================================================================== Payer authentication is the `Cybersource` implementation of 3-D Secure. It deters unauthorized card use and provides added protection from fraudulent chargeback activity. `Secure Acceptance` supports 3-D Secure 1.0 and 2.0. Before you can use `Cybersource` Payer Authentication, you must contact `Cybersource` Customer Support so that `Cybersource` can configure your account. Your merchant ID must be enabled for payer authentication. For more information about payer authentication, see the [Payer Authentication Developer Guides](https://developer.cybersource.com/docs.md#PayerAuthentication ""). For `Secure Acceptance`, `Cybersource` supports these kinds of payer authentication: * American Express SafeKey * China UnionPay (3-D Secure 2.0 only) * Diners ProtectBuy * J/Secure by JCB * Mastercard Identity Check * Visa Secure For each transaction, you receive detailed information in the replies and in the transaction details page of the Business Center. You can store this information for 12 months. `Cybersource` recommends that you store the payer authentication data because you can be required to display this information as enrollment verification for any payer authentication transaction that you present again because of a chargeback. Your merchant account provider can require that you provide all data in human-readable format. The language used on each payer authentication page is determined by your issuing bank and overrides the locale that you specified. If you use the test card numbers, the default language used on the payer authentication page is English and overrides the locale you have specified. See [Test and View Transactions](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-test-view-txns.md ""). Reseller: Configuring Payer Authentication {#sa-configure-payer-authentication-reseller} ======================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Choose the 3-D Secure version that you want to use. If you choose 3-D Secure 2.0 and the card issuer is not 3-D Secure 2.0 ready, some transactions might still authenticate over 3-D Secure 1.0. The payer_authentication_specification_version response field indicates which version was used. 5. Click Save. The card types that support payer authentication are: * American Express * Cartes Bancaires * China UnionPay * Diners Club * JCB * Mastercard * Maestro (UK Domestic or International) * Visa Reseller: Enabling Automatic Authorization Reversals {#sa-enable-automatic-auth-reversals-reseller} =================================================================================================== For transactions that fail to return an address verification system (AVS) or a card verification number (CVN) match, you can enable `Secure Acceptance` to perform an automatic authorization reversal. An automatic reversal releases the reserved funds held against a customer's card. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Check Fails AVS check. Authorization is automatically reversed on a transaction that fails an AVS check. 5. Check Fails CVN check. Authorization is automatically reversed on a transaction that fails a CVN check. 6. Click Save. #### ADDITIONAL INFORMATION When the AVS and CVN options are disabled and the transaction fails an AVS or CVN check, the customer is notified that the transaction was accepted. You are notified to review the transaction details. See [Types of Notifications](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-notification-types.md ""). Reseller: Enabling ACH Payments {#sa-enable-echecks-reseller} ============================================================= An ACH payment is a payment made directly from your customer's U.S. or Canadian bank account. As part of the checkout process, you must display a terms and conditions statement for ACH transactions. A customer must accept the terms and conditions before submitting an order. Within the terms and conditions statement it is recommended to include a link to the table of returned item fees. The table lists by state the amount that your customer has to pay when a check is returned. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Check Enable Echeck Payments. The list of account types appears. 5. Check the account type(s): #### ADDITIONAL INFORMATION * Checking * Savings * Corporate Checking * General Ledger 6. Click Add Currencies. The ACH settings page appears. 7. Check Select All or select a currency. 8. Click Save. #### RESULT You must configure the ACH information fields. See [Reseller: Configuring ACH Information Fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-portfolio-reseller-mgmt/sa-checkout-configuration/sa-configure-echeck-info-fields-reseller.md ""). `Visa Click to Pay` Configuration {#sa-visa-clicktopay-configuration-reseller} ============================================================================== You must enroll in `Visa Click to Pay` and create a `Visa Click to Pay` profile before you can enable it as a payment method. See *Visa Click to Pay* ([PDF](http://apps.cybersource.com/library/documentation/dev_guides/VCO_Getting_Started/Visa_Checkout_Getting_Started.pdf "") \| [HTML](http://apps.cybersource.com/library/documentation/dev_guides/VCO_Getting_Started/html/ "")). Only the authorization and sale transaction types are supported for `Visa Click to Pay` transactions. Visa Click to Pay uses Visa Checkout services and API fields. The payment methods selection page is displayed as part of the checkout process for either of these scenarios: * Multiple payment methods are enabled for the profile and no payment_method field is included in the request. * `Visa Click to Pay` is the only enabled payment method for the profile. * payment_method=`visacheckout` is included in the request. `Visa Click to Pay` requires the customer to enter only a username and password to pay for goods. It eliminates the need to enter account, shipping, and billing information. The customer logs in to their `Visa Click to Pay` account and chooses the card with which they would like to pay. If the `Secure Acceptance` profile is enabled to request the payer authentication service for a specific card type, the customer is redirected to the relevant payer authentication screen before `Secure Acceptance` processes the transaction and redirects the customer to your website. Reseller: Configuring `Visa Click to Pay` {#sa-configure-visa-clicktopay-reseller} ================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Check Enable `Visa Click to Pay`. 5. Click Save. 6. In the left navigation panel, choose Payment Configuration \> Digital Payment Solutions. 7. Click Save. #### RESULT To configure the payment method for `Visa Click to Pay`, log in to the [Business Center](https://businesscenter.cybersource.com "") and go to Configuring `Visa Click to Pay`. Reseller: Enabling PayPal Express Checkout {#sa-enable-paypal-express-checkout-reseller} ======================================================================================== PayPal Express Checkout is not supported on a `Secure Acceptance` iframe integration. Contact `Cybersource` Customer Support to have your `Cybersource` account configured for this feature. You must also create a PayPal business account; see [*PayPal Express Checkout Services Using Alternative Payment Services Simple Order API*](https://docs.cybersource.com/content/dam/new-documentation/documentation/en/altpay-paypal-express/developer/all/so/altpay-paypalexpress-so.pdf ""). Add the PayPal Express Checkout payment method to the `Secure Acceptance` `Hosted Checkout Integration` payment methods selection page. Redirect the customer to their PayPal account login. When logged in to their PayPal account they can review orders and edit shipping or payment details before completing transactions. The payment methods selection page is displayed as part of the checkout process when multiple payment methods are enabled for the profile and no payment_method field is included in the request. If you include payment_method=`paypal` in the request, the payment methods selection page is not displayed and the customer is redirected to PayPal. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Check Enable PayPal Express Checkout. 5. Click Save. Service Fees {#sa-service-fees} =============================== Contact `Cybersource` Customer Support to have your `Cybersource` account configured for this feature. Service fees are supported only if Wells Fargo is your acquiring bank and FDC Nashville Global is your payment processor. The service fee setting applies to the card and ACH payment methods. To apply the service fee to only one payment method, create two `Secure Acceptance` profiles with the appropriate payment methods enabled on each: one with the service fee feature enabled and one with the service fee feature disabled. As part of the checkout process, you must display a terms and conditions statement for the service fee. A customer must accept the terms and conditions before submitting an order. Reseller: Enabling Service Fees {#sa-enable-service-fees} ========================================================= 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Settings. The Payment Settings page appears. 4. Check Service Fee applies on transactions using this profile. The service fee terms and conditions URL and the service fee amount are added to the customer review page. #### ADDITIONAL INFORMATION > Transactions fail if you disable this feature. Do not disable this feature unless instructed to do so by your account manager. 5. Click Save. #### ADDITIONAL INFORMATION After you save the profile you cannot disable the service fee functionality for that profile. All transactions using the profile will include the service fee amount. Security Keys {#sa-security-keys-reseller} ========================================== Before you can activate a profile, you must create a security key to protect each transaction from data tampering. A security key expires in two years. You cannot use the same security key for both test and production transactions. You must download a security key for each versions of `Secure Acceptance` for test and production. * **Test** : [businesscentertest.cybersource.com](https://businesscentertest.cybersource.com "") * **Production** : [businesscenter.cybersource.com](https://businesscenter.cybersource.com "") * **Production in India** : [businesscenter.in.cybersource.com](https://businesscenter.in.cybersource.com "") On the Profile Settings page, click Security. The Security Keys page appears. The security script signs the request fields using the secret key and the HMAC SHA256 algorithm. To verify data, the security script generates a signature to compare with the signature returned from the `Secure Acceptance` server. You must have an active security key to activate a profile. Reseller: Creating Security Keys {#sa-create-security-keys-reseller} ==================================================================== 1. In the left navigation panel, choose Payment Configuration \> Key Management. 2. Click Generate Key. 3. Select a key type. 4. Click Next Step. 5. Select the key subtype **`Secure Acceptance`**. 6. Click Next Step. 7. Enter a key name (required). 8. Choose signature version 1. 9. Choose signature method HMAC-SHA256. 10. Select a security profile. 11. Click Submit. 12. Click Generate Key. The Create New Key window expands and displays the new access key and secret key. This window closes after 30 seconds. 13. Copy and save the access key and secret key. #### ADDITIONAL INFORMATION * Access key: Secure Sockets Layer (SSL) authentication with `Secure Acceptance`. You can have many access keys per profile. See [Scripting Language Samples](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-samples-scripting-languages.md ""). * Secret key: signs the transaction data and is required for each transaction. Copy and paste this secret key into your security script. See [Scripting Language Samples](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-samples-scripting-languages.md ""). When done pasting the secret keys into your script, delete the copied keys from your clipboard or cached memory. By default, the new security key is active. The other options for each security key are: * Deactivate: deactivates the security key. The security key is inactive. * Activate: activates an inactive security key. * View: displays the access key and security key. When you create a security key, it is displayed in the security keys table. You can select a table row to display the access key and the secret key for that specific security key. 14. Click Key Management. The Key Management page appears. Reseller: Configuring the Payment Form {#sa-configure-payment-form-reseller} ============================================================================ 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Form. The Payment Form page appears. 4. Choose the payment form flow: * Multi-step payment form---the checkout process consists of a sequence of pages on which the customer enters or reviews information before submitting a transaction. The default sequence is payment selection (if multiple payment methods are enabled), billing, shipping, payment, review, and receipt. * Single page form---the checkout process consists of one page on which the customer enters or reviews information before submitting a transaction. #### ADDITIONAL INFORMATION Do not click Save until you have selected the billing or shipping fields, or both. 5. Check **Display the total tax amount in each step of the checkout process**. #### ADDITIONAL INFORMATION The total tax amount must be included in each transaction. Calculate and include the total tax amount in the tax_amount field. Do not click Save until you have selected the billing or shipping fields, or both. 6. Click Save. Reseller: Configuring Billing Information Fields {#sa-configure-billing-info-fields-reseller} ============================================================================================= > Select the billing information fields that your merchant provider requires. > If the billing country is U.S. or Canada, you can select the state code field as a required field. ` Cybersource ` recommends that if the billing country is U.S. or Canada, the state code and the postal code fields bee selected as required. If the billing country is located in the rest of the world, you can also select the state code field as a required field. > Select the customer billing information fields that you want displayed on `Secure Acceptance`. If these fields are captured at an earlier stage of the order process (for example on your website), they can be passed into `Secure Acceptance` as hidden form fields. See [Request Fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-wm-api-fields/sa-request-fields.md ""). You can shorten the checkout process by not selecting billing information. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Form. The Payment Form page appears. 4. Check Billing Information. The billing information fields appear. 5. Check the billing information fields that your merchant provider requires. The options for each field are: * Display: the customer can view the information displayed in this field. Choose this option if you want to pre-populate the billing information fields when `Secure Acceptance` Hosted Checkout is rendered---these fields must be passed into `Secure Acceptance` as hidden form fields. * Edit: the customer can view and edit the billing information on the `Secure Acceptance` Hosted Checkout. When you select this option, the display option is automatically selected. * Require: the customer is required to enter the billing information on the `Secure Acceptance` Hosted Checkout before they submit the transaction. When you select this option, all other options are automatically selected. #### ADDITIONAL INFORMATION Do not click Save until you have selected the billing and order review fields. 6. Click Save. Reseller: Configuring Shipping Information Fields {#sa-config-shipping-info-fields-reseller} ============================================================================================ Select the shipping information fields that your merchant provider requires. Select the customer shipping information fields that you want displayed on `Secure Acceptance`. These fields are optional. If you do not add these fields, the shipping information step is removed from `Secure Acceptance`. If these fields are captured at an earlier stage of the order process (for example, on your website), they can be passed into `Secure Acceptance` as hidden form fields. See [Request Fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-wm-api-fields/sa-request-fields.md ""). You can shorten the checkout process by not selecting billing information. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Form. The Payment Form page appears. 4. Check Shipping Information. 5. Check the shipping information fields that are required by your merchant provider. The options for each field are: * Display: the customer can view the information displayed in this field. Choose this option if you want to pre-populate the shipping information fields when `Secure Acceptance` `Hosted Checkout Integration` is rendered---these fields must be passed into `Secure Acceptance` as hidden form fields. * Edit: the customer can view and edit the shipping information on the `Secure Acceptance` Hosted Checkout. When you select this option, the display option is automatically selected. * Require: the customer is required to enter the shipping information on the `Secure Acceptance` Hosted Checkout before they submit the transaction. When you select this option, all other options are automatically selected. #### ADDITIONAL INFORMATION Do not click Save until you have selected the shipping and order review fields. 6. Click Save. Reseller: Configuring ACH Information Fields {#sa-configure-echeck-info-fields-reseller} ======================================================================================== Select the ACH account information fields that your merchant provider requires. Select the customer ACH account information fields that you want displayed on `Secure Acceptance`. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Form. The Payment Form page appears. 4. Check the ACH account information to be included in `Secure Acceptance`. The options for each field are: * Display: the customer can view the information displayed in this field. Choose this option if you want to pre-populate the ACH information fields when the `Secure Acceptance` Hosted Checkout is rendered. * Edit: the customer can view and edit the ACH information on the `Secure Acceptance` Hosted Checkout. When you select this option, the display option is automatically selected. * Require: the customer is required to enter the ACH information on the `Secure Acceptance` Hosted Checkout before they submit the transaction. When you select this option, all other options are automatically selected. #### ADDITIONAL INFORMATION Do not click Save until you have selected the ACH account information and order review fields. 5. Click Save. Reseller: Configuring Order Review Details {#sa-configure-order-review-details-reseller} ======================================================================================== Select the fields that you want displayed on the Order Review page of `Secure Acceptance` Hosted Checkout. The customer reviews this information before submitting a transaction. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Payment Form. The Payment Form page appears. 4. Check the fields that you want displayed on the Order Review page of `Secure Acceptance` Hosted Checkout. The options for each field are: * Display: the customer can view the information contained in this field. Available only for billing and shipping information. * Edit: the customer can view and edit the information contained in this field. 5. Click Save. Reseller: Configuring Merchant Notifications {#sa-configure-merchant-notifs-reseller} ===================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Notifications. The Notifications page appears. 4. Choose a merchant notification in one of two ways: * Check Merchant POST URL. Enter the HTTPS URL. `Cybersource` sends transaction information to this URL. For more information, see [Response Fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-wm-api-fields/sa-response-fields.md ""). Only an HTTPS URL supporting TLS 1.2 or higher should be used for the merchant POST URL. If you encounter any problems, contact `Cybersource` Customer Support. * Check Merchant POST Email. Enter your email address. `Cybersource` sends transaction response information to this email address including payment information, return codes, and all relevant order information. See [Response Fields](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-wm-api-fields/sa-response-fields.md ""). 5. Choose the card number digits that you want displayed in the merchant or customer receipt: * Return payment card BIN: displays the card's Bank Identification Number (BIN), which is the first six digits of the card number. All other digits are masked: 123456xxxxxxxxxx * Return last four digits of payment card number: displays the last four digits of the card number. All other digits are masked: xxxxxxxxxxxx1234 * Return BIN and last four digits of payment card number: displays the BIN and the last four digits of the card number. All other digits are masked: 123456xxxxxx1234 6. Click Save. Customer Receipts {#sa-customer-receipts-reseller} ================================================== You can send a purchase receipt email to your customer and a copy to your own email address. Both are optional. Customers can reply with questions regarding their purchases, so use an active email account. The email format is HTML unless your customer email is rich text format (RTF). Reseller: Configuring Customer Notifications {#sa-config-customer-notifs-reseller} ================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Notifications. The Notifications page appears. 4. Check Email Receipt to Customer. 5. Enter the sender email address to be displayed on the customer receipt. The customer will reply to this email with any queries. 6. Enter the sender name of your business. It is displayed on the customer receipt. 7. Check Send a copy to. This setting is optional. 8. Enter your email address to receive a copy of the customer's receipt. #### ADDITIONAL INFORMATION Your copy of the customer receipt will contain additional transaction response information. 9. Check Display Notification Logo. 10. Click Upload Company Logo. Find and upload the image that you want to display on the customer receipt and email. #### ADDITIONAL INFORMATION The image file must not exceed 840 (width) x 60 (height) pixels and must be GIF, JPEG, or PNG. The logo filename must not contain any special characters, such as a hyphen (-). 11. Check Custom Email Receipt. #### ADDITIONAL INFORMATION `Cybersource` recommends that you implement a DNS configuration to enable `Cybersource` to send email receipts on your behalf. 12. Check the type of email receipt that you want to send to a customer: * Standard email receipt: this email is automatically translated based on the locale used for the transaction. * Custom email receipt: this email can be customized with text and data references. The email body section containing the transaction detail appears between the header and footer. Custom text is not translated when using different locales are used. 13. Check custom email subject and enter up to 998 characters. When the maximum number of characters is exceeded, the subject heading defaults to *Order Confirmation*. #### ADDITIONAL INFORMATION You can insert email smart tags in the email subject, header, and footer sections to include specific information. Select each smart tag from the drop-down list and click Insert. 14. Click Save. Customer Response Page {#sa-customer-response-pg-reseller} ========================================================== You must configure the customer response page before you can activate a profile. You can choose to have a transaction response page displayed to the customer at the end of the checkout process, and a cancel response page displayed during the checkout process. Enter a URL for your own customer response page or use the `Cybersource` hosted response pages. Depending upon the transaction result, the `Cybersource` hosted response pages are Accept, Decline, or Error. Review declined orders as soon as possible because you might be able to correct problems related to address or card verification, or you might be able to obtain a verbal authorization. You can also choose to display a web page to the customer after the checkout process is completed. Reseller: Configuring a `Cybersource` Hosted Response Page {#sa-configure-co-hosted-response-page-reseller} =========================================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Customer Response. The Customer Response page appears. 4. Under the Transaction Response Page heading, check Hosted by `Cybersource`. 5. Under the Transaction Response Message heading, choose a number from the Retry Limit drop-down list. The maximum number of times a customer can retry a declined transaction is five. 6. Under the Customer Redirect after Checkout heading, enter the redirect URL of the web page. This web page is displayed to the customer after the checkout process is completed. 7. Click Save. Reseller: Configuring a Custom Hosted Response Page {#sa-configure-custom-hosted-response-page-reseller} ======================================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Customer Response. The Customer Response page appears. 4. Under the Transaction Response Page heading, check Hosted by You. 5. Enter the URL for your customer response page. Use port 80, 443, or 8080 in your URL. #### ADDITIONAL INFORMATION Only port 443 should be used with a HTTPS URL. A POST request with the transaction data is provided to this URL after the customer completes checkout. The POST request contains the reason code value of the transaction, which helps you determine possible actions to take on the transaction. See [Reason Codes](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-reason-codes.md ""). 6. Under the Transaction Response Message heading, choose a number from the Retry Limit drop-down list. The maximum number of times a customer can retry a declined transaction is 5. 7. Under the Customer Redirect after Checkout heading, enter the redirect URL of the web page. This web page is displayed to the customer after the checkout process is completed. 8. Click Save. Reseller: Configuring a Custom `Cybersource` Hosted Response Page {#sa-configure-custom-hosted-response-pg-reseller} ==================================================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Customer Response. The Customer Response page appears. 4. Under the Custom Cancel Response Page heading, check Hosted by `Cybersource`. 5. Click Save. Reseller: Configuring a Custom Cancel Response Page {#sa-configure-custom-cancel-response-pg-reseller} ====================================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Customer Response. The Customer Response page appears. 4. Under the Custom Cancel Response Page heading, check Hosted by You. 5. Enter the URL for your customer response page. Use port 80, 443, or 8080 in your URL. #### ADDITIONAL INFORMATION Only port 443 should be used with a HTTPS URL. A POST request with the transaction data is provided to this URL after the customer completes checkout. The POST request contains the reason code value of the transaction, which helps you determine possible actions to take on the transaction. See [Reason Codes](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-reason-codes.md ""). 6. Click Save. Custom Checkout Appearance {#sa-custom-checkout-appearance-reseller} ==================================================================== Customize the appearance and branding of the `Secure Acceptance` checkout pages by choosing a background color, font, and text color. Upload a logo or image, and align it within the header or footer. `Cybersource` recommends that you preview your changes in the Image Preview window. To display an image as the header banner of the payment form, the image dimensions must not exceed 840 (width) x 60 (height) pixels and the image size must not exceed 100 kB. To display a small logo within the header banner, the logo height must not exceed 60 pixels. The image file must be GIF, JPEG, or PNG. Reseller: Changing Header Content {#sa-change-header-content-reseller} ====================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Branding. The Branding page appears. 4. Check Display Header. 5. Click the header color. 6. Choose a color in one of two ways: * Enter a hexadecimal value for the header color of the payment form. * Click within the header color palette to choose a color. Click the color to confirm your selection. 7. Click Browse to upload the image to display as the header banner or as a logo within the header banner. 8. Choose the alignment option for the image or logo: left-aligned, centered, or right-aligned. 9. Click Save. Reseller: Changing Body Color and Font Settings {#sa-change-body-color-font-settings-reseller} ============================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Branding. The Branding page appears. 4. Choose a background color for the main body in one of two ways: * Enter a hexadecimal value for the background color. * Click within the header color palette to choose a color. Click the color to confirm your selection. 5. Select a text font from the drop-down list. 6. Choose a text color in one of two ways: * Enter a hexadecimal value for the text color. * Click within the header color palette to choose a color. Click the color to confirm your selection. 7. Click Save. 8. Click Set to Default to restore all the default settings on this page. Reseller: Changing Background and Text Color of the Total Amount {#sa-change-bckgrd-text-color-total-amt-reseller} ================================================================================================================== > If you are implementing the iframe embedded version of ` Secure Acceptance ` Hosted Checkout, the total amount figure is not displayed within the iframe. Any settings you select below are ignored. 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Branding. The Branding page appears. 4. Choose a background color in one of two ways: * Enter a hexadecimal value for the background color. * Click within the header color palette to choose a color. Click the color to confirm your selection. 5. Choose a text color in one of two ways: * Enter a hexadecimal value for the text color of the total amount. * Click within the header color palette to choose a color. Click the color to confirm your selection. 6. Click Save. 7. Click Set to Default to restore all the default settings on this page. Reseller: Changing the Progress Bar Color {#sa-change-progress-bar-color-reseller} ================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Branding. The Branding page appears. 4. Choose a color in one of two ways: * Enter a hexadecimal value for the color of the progress bar. * Click within the header color palette to choose a color. Click the color to confirm your selection. 5. Click Save. 6. Click Set to Default to restore all the default settings on this page. Reseller: Changing Color and Text on Pay or Finish Button {#sa-change-color-text-pay-or-finish-button-reseller} =============================================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Branding. The Branding page appears. 4. Choose a background color of the pay or the finish button in one of two ways: * Enter a hexadecimal value for the background color. * Click within the header color palette to choose a color. Click the color to confirm your selection. 5. Choose a color of the pay or the finish button text in one of two ways: * Enter a hexadecimal value for the text. * Click within the header color palette to choose a color. Click the at the bottom right to confirm your selection. 6. Check Change Button text. A text box appears for the pay button. 7. Enter the text you want displayed on the pay button. This button text is required. 8. Enter the text you want displayed on the finish button. This button text is required. 9. Click Save. 10. Click Set to Default to restore all the default settings on this page. Reseller: Changing Footer Color and Uploading a Small Logo or Image {#sa-change-foot-color-upld-sm-logo-img-reseller} ===================================================================================================================== 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Choose a profile. The General Settings page appears. 3. Click Branding. The Branding page appears. 4. Check Display Footer. 5. Choose a color in one of two ways: * Enter a hexadecimal value for the footer color of the payment form. * Click within the header color palette to choose a color. Click the color to confirm your selection. 6. Click Browse to upload a footer logo. Upload the image that you want displayed within the footer of the payment form. 7. To display a small logo or image in the footer of the payment form, the file must not exceed 840 (width) x 60 (height) pixels. The image file must be GIF, JPEG, or PNG. 8. Choose the alignment option for the image: left-aligned, centered, or right-aligned. 9. Click Save. 10. Click Set to Default to restore all the default settings on this page. Reseller: Activating a Profile {#sa-activate-profile-reseller} ============================================================== > You must complete the required settings described in each of these sections before activating a profile: > > * [Payment Method Configuration](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-portfolio-reseller-mgmt/sa-payment-method-configuration-reseller.md "") > * [Security Keys](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-portfolio-reseller-mgmt/sa-security-keys-reseller.md "") > * [Customer Response Page](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/sa/developer/all/sa-hosted/secure-acceptance/sa-portfolio-reseller-mgmt/sa-customer-response-pg-reseller.md "") 1. In the left navigation panel, choose Portfolio Management \> `Secure Acceptance` Profiles. The `Secure Acceptance` Profile page appears. 2. Perform one of these steps: * On the Active Profiles tab, choose a profile and click Publish Profile. * On the Edit Profile page, click Publish Profile. 3. Click Confirm. Reseller: Additional Profile Options {#sa-additional-profile-options-reseller} ============================================================================== * Copy---duplicates the active profile and creates an editable version. The editable version is listed in the inactive profile list. This option is available only for an active profile. * Deactivate---deactivates the active profile. The profile is now listed in the inactive profile list. This option is available only for an active profile. * Publish to Active---activates the inactive profile. This option is available only for an inactive profile.