Loading
Prepare for Email to Become the Default Login ExperienceRead More
US/Canada Toll-Free Callers Experiencing Silence After Agentforce Voice GreetingRead More
Point of Sale
Configuring Notifications for Verifone

You are here:

  1. Salesforce Help
  2. Docs
  3. Point of Sale

Configuring Notifications for Verifone

Use Verifone Central Notifications in Point of Sale to receive transaction status updates and automate business processes, such as order management and report downloads.

Only users with Merchant Admin, Merchant Cashier, or Merchant Supervisor roles can access this section.

Events

Events are the topics a notification is 'listening' to. The notifications will be triggered as soon as there's an event happening for one of the selected topics. Salesforce requires these events to be configured.

Event Description
TxnAuthorisationApproved (Authorization approved) An approved authorization or preauthorization
TxnAuthorisationDeclined (Authorization declined) A declined authorization or preauthorization
TxnSaleApproved (Sales approved) A single approved message sale (auth+capture)
TxnSaleDeclined (Sales declined) A single declined message sale (auth+capture)

To verify Salesforce receives Verifone callbacks for authorizations and sales, a callback URL is required. These URLs vary based on the merchant, region, and environment combination.

  1. In CMS, go to Integrations > Payment Gateways.
  2. Edit the VERIFONEPSDK payment gateway created for pay by link.
  3. Under Callback URL, select Generate. It can take a few seconds to generate the URL. The Callback URL screen in the Payment Gateway section of Verifone Central.
  4. Copy the URL and configure it in the Verifone Notifications settings.

Create Notifications in Verifone Central

To use the information in the Notifications section in Verifone Central, follow these steps:

  1. Log in to your Verifone Central account.
  2. Go to Administration > Notifications. The Notifications page displays.
  3. Select Create new notification. On the Notifications page, sort the notifications you've made by name, email, or URL. You can also use the Event type or Status filters. The Notifications page with the Create New Notification button highlighted.
  4. On the Create Notification page, provide the following information:
    1. Notification name: Used to identify the notification configuration in the listing
    2. Organization(s):
    3. By selecting an organization, you apply a scope to the configuration
    4. By selecting a root-level organization, the notifications will send messages for all child organizations
    5. By selecting the lowest-level organization, you will receive messages for the selected organization only. You can select to send the same notification to multiple organizations.
    6. Events: Notifications will be sent as soon as an event happens for one of the transaction status updates you chose. For a list of events that Point of Sale needs, see Events.
    7. Delivery Method: Specifies how notifications will be delivered. Select "URL Endpoint" and Verifone will send a webhook with the transaction payload. Only one webhook will be accepted.
    8. URL Endpoint: Paste the callback URL you previously generated in Generate Callback URLs in CMS.
    9. Webhook Type: Select "Full event payload" to send webhooks to Point of Sale with full content payload. The Create Notification screen in Verifone Central.
Important
Important If a new webhook is added, it is loaded within 60 seconds. However, updates to existing webhooks can take 10 to 60 minutes depending on server load.

Webhook Samples (Full Event Payload)

Your webhook will receive a POST HTTP call with payloads:

Authorization Approved:

{ "eventType": "TxnAuthorisationApproved", "objectType": "TransactionEvent",
          "eventId": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "eventDateTime":
          "2023-03-02T13:16:44.654Z", "recordId": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8",
          "entityUid": "07652580-1037-4901-92f2-74676cb8aa7e", "source": "pdsp",
          "content": { "id": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "currency_code":
          "EUR", "country_code": "NL", "created_at": "2023-03-02T13:16:44.654Z",
          "customer": "18c4694c-b498-40fa-ab9d-fbe671c0afca", "customer_ip": "127.0.0.1",
          "dynamic_descriptor": "Test Transaction", "payment_product": "CARD",
          "payment_product_type": "VISA", "transaction_type": "SALE",
          "transaction_status": "FAILED", "shipping_information": { "address": "Singel
          250", "city": "Amsterdam", "country": "NL", "phone": "31633344455",
          "postal_code": "1012 AB", "state": "Noord-Holland" }, "user_agent": "string",
          "cvv_present": false, "card_brand": "VISA", "masked_card_number":
          "430000******7107", "merchant_id": "290010026", "merchant_reference": "200001",
          "shopper_interaction": "ecommerce", "threed_authentication": { "eci_flag": "05",
          "enrolled": "Y", "cavv": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=", "pares_status": "Y",
          "ds_transaction_id": "020100004317fdc3ad2454438000000000000891", "threeds_version":
          "2.1.0" }, "amount": "3.0", "payment_summary": {} } }

Authorization Declined

{ "eventType": "TxnAuthorisationDeclined", "objectType": "TransactionEvent",
          "eventId": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "eventDateTime":
          "2023-03-02T13:16:44.654Z", "recordId": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8",
          "entityUid": "07652580-1037-4901-92f2-74676cb8aa7e", "source": "pdsp",
          "content": { "id": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "currency_code":
          "EUR", "country_code": "NL", "created_at": "2023-03-02T13:16:44.654Z",
          "customer": "18c4694c-b498-40fa-ab9d-fbe671c0afca", "customer_ip": "127.0.0.1",
          "dynamic_descriptor": "Test Transaction", "payment_product": "CARD",
          "payment_product_type": "VISA", "transaction_type": "SALE",
          "transaction_status": "FAILED", "shipping_information": { "address": "Singel
          250", "city": "Amsterdam", "country": "NL", "phone": "31633344455",
          "postal_code": "1012 AB", "state": "Noord-Holland" }, "user_agent": "string",
          "cvv_present": false, "card_brand": "VISA", "masked_card_number":
          "430000******7107", "merchant_id": "290010026", "merchant_reference": "200001",
          "shopper_interaction": "ecommerce", "threed_authentication": { "eci_flag": "05",
          "enrolled": "Y", "cavv": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=", "pares_status": "Y",
          "ds_transaction_id": "020100004317fdc3ad2454438000000000000891", "threeds_version":
          "2.1.0" }, "amount": "3.0", "payment_summary": {} } }

Sale Approved

{ "eventType": "TxnSaleApproved", "objectType": "TransactionEvent", "eventId":
          "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "eventDateTime": "2023-03-02T13:16:44.654Z",
          "recordId": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "entityUid":
          "07652580-1037-4901-92f2-74676cb8aa7e", "source": "pdsp", "content": { "id":
          "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "currency_code": "EUR", "country_code":
          "NL", "created_at": "2023-03-02T13:16:44.654Z", "customer":
          "18c4694c-b498-40fa-ab9d-fbe671c0afca", "customer_ip": "127.0.0.1",
          "dynamic_descriptor": "Test Transaction", "payment_product": "CARD",
          "payment_product_type": "VISA", "transaction_type": "SALE",
          "transaction_status": "FAILED", "shipping_information": { "address": "Singel
          250", "city": "Amsterdam", "country": "NL", "phone": "31633344455",
          "postal_code": "1012 AB", "state": "Noord-Holland" }, "user_agent": "string",
          "cvv_present": false, "card_brand": "VISA", "masked_card_number":
          "430000******7107", "merchant_id": "290010026", "merchant_reference": "200001",
          "shopper_interaction": "ecommerce", "threed_authentication": { "eci_flag": "05",
          "enrolled": "Y", "cavv": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=", "pares_status": "Y",
          "ds_transaction_id": "020100004317fdc3ad2454438000000000000891", "threeds_version":
          "2.1.0" }, "amount": "3.0", "payment_summary": {} } }

Sale Declined

{ "eventType": "TxnSaleDeclined", "objectType": "TransactionEvent", "eventId":
          "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "eventDateTime": "2023-03-02T13:16:44.654Z",
          "recordId": "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "entityUid":
          "07652580-1037-4901-92f2-74676cb8aa7e", "source": "pdsp", "content": { "id":
          "5b5f42f6-db9f-4fd8-8396-1527ec621ab8", "currency_code": "EUR", "country_code":
          "NL", "created_at": "2023-03-02T13:16:44.654Z", "customer":
          "18c4694c-b498-40fa-ab9d-fbe671c0afca", "customer_ip": "127.0.0.1",
          "dynamic_descriptor": "Test Transaction", "payment_product": "CARD",
          "payment_product_type": "VISA", "transaction_type": "SALE",
          "transaction_status": "FAILED", "shipping_information": { "address": "Singel
          250", "city": "Amsterdam", "country": "NL", "phone": "31633344455",
          "postal_code": "1012 AB", "state": "Noord-Holland" }, "user_agent": "string",
          "cvv_present": false, "card_brand": "VISA", "masked_card_number":
          "430000******7107", "merchant_id": "290010026", "merchant_reference": "200001",
          "shopper_interaction": "ecommerce", "threed_authentication": { "eci_flag": "05",
          "enrolled": "Y", "cavv": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=", "pares_status": "Y",
          "ds_transaction_id": "020100004317fdc3ad2454438000000000000891", "threeds_version":
          "2.1.0" }, "amount": "3.0", "payment_summary":{} } }

Update Notifications in Verifone Central

Any notification can be edited. These updates can be applied to a notification:

  • Update the notification name
  • Add/remove organisation(s)
  • Add/remove events
  • Change the delivery method
  • Enable / disable / delete the notification

The notification settings for the Test notification in Verifone Central

Important
Important

A notification can be deleted only after being turned off.

Notification Failures

Notification failures can only happen for webhook events if the system doesn't tell the merchant (for example, the URL endpoint can't be reached or service is down/time out).

The failed notifications can be viewed in Administration > Notifications. Select the notification and go to the Notification Failures section from Verifone Central.

 
Loading
Salesforce Help | Article