Payson Form

Payson allows you to take payments in your store via Payson. Payson cooperates with Visa, MasterCard, and the Swedish online banks Swedbank, Handelsbanken, SEB, and Nordea.

General information

↑ Back to top

When the order goes through, the user is taken to Payson to make a secure payment. No SSL certificate is required on your site. After payment the order is confirmed and the user is taken to the thank you page.

The Payson extension acts as two separate payment methods: one for Payson Direct (credit card payments and online bank payment) and one for Payson Invoice.

To use this extension, you require a Payson merchant account. You’ll also need to request an AgentID and an MD5-hash from Payson.

To utilize Payson Invoice you need to activate this feature in your Payson account. Contact Payson for further information about this.

Note: This extension will only work if the currency is set to Swedish krona or euros, with the base country set as Sweden or Finland. To use the Payson Invoice feature, your store currency must be set to Swedish krona.

Payson Direct

↑ Back to top

Direct Payments allow you to take credit card payments — as well as direct payments —  via any of the associated banks.

Direct Payments supports Payson Guarantee (which can be turned on and off). Payson Guarantee means that the buyer will have the opportunity to inspect and approve or deny the merchandise before the payment is finally transferred to the seller.

Payson Invoice

↑ Back to top

The Payson gateway also offers Payson Invoice, allowing your customers to receive their order and pay by invoice later.

Installation

↑ Back to top

• Purchase and download the plugin zip file from WooCommerce.com
• Log in to your store’s WP Admin dashboard and navigate to Plugins > Add New from the left-hand menu
• Click the Upload button, then Browse to select the zip file from your computer. Once selected, click OK, then Install Now.
• Finally, click Activate.

Configuration: Payson Direct

↑ Back to top

• To configure this extension, in your store’s WP Admin dashboard, navigate to WooCommerce > Settings and click the Payment Gateways tab. You should see Payson Direct listed as an option.
• Optionally you can select the radio button next to this option to make it your store’s default gateway.
• You should see “Payson Direct” displayed across the top of the page as a link. Click on this to configure the extension, and you will see a list of options:
  • Enable or disable the checkbox for this gateway.
  • The Title option allows you to determine what your customers will see this payment option described as on the checkout page.
  • The Description box controls the message that appears under the payment fields on the checkout page.
  • Payson email address – the email address tied to your Payson account.
  • Agent ID – Requested from Payson (Login to your Payson account and navigate to My account > Integration to retrieve your AgentID).
  • MD5 – Requested from Payson (Log in to your Payson account dashboard and navigate to My account > Integration to retrieve your MD5 key).
  • Payson Guarantee – Whether Payson Guarantee is offered or not. Get more information about Payson Guarantee. 
  • Language – Set the language in which the page will be opened when the customer is redirected to Payson.
  • Debug – If this option is checked then details of communication with Payson are stored in a debug log at location /wp-content/plugins/woocommerce/logs/payson.txt.
  • Click Save changes.

Configuration: Payson Invoice

↑ Back to top

• in your store’s WP Admin dashboard, navigate to WooCommerce > Settings and click the Payment Gateways tab
• You should see “Payson Invoice” displayed across the top of the page as a link. Click on this to configure the extension; you will see a list of options:
  • Enable/disable the checkbox for this gateway.
  • The “Title” option allows you to determine what your customers will see this payment option described as on the checkout page.
  • The “Description” box controls the message that appears under the payment fields on the checkout page.
  • Payson email address – the email address tied to your Payson account.
  • Agent ID – Requested from Payson.
  • MD5 – Requested from Payson.
  • Language – Set the language in which the page will be opened when the customer is redirected to Payson.
  • Invoice fee – Enter the Invoice fee product ID in this text field if you want to utilize the Invoice fee feature.
  • Debug – If this option is checked then details of communication with Payson are stored in a debug log at location /wp-content/plugins/woocommerce/logs/payson.txt.
  • Click Save changes.

Invoice fee setup

↑ Back to top

The invoice fee for Payson Invoice is added as a simple (hidden) product. To create an Invoice fee product:

1. Add a simple (hidden) product. Mark it as a taxable product.
2. Go to the Payson Invoice settings page and add the ID of the invoice fee product in the field Invoice fee. The ID can be found by hovering over the invoice fee product on the Products page in WooCommerce.
   Note – do not add SKU or price of the invoice fee. Add the product ID in the settings field for the invoice fee.

Testing

↑ Back to top

A separate test system is available that can be used to test your integration. It has the same functionality as the live API including IPN, but no real money will be moved. For bank and credit card payments a bank simulation page will be shown in place of the live bank page which allow you to simulate an OK or denied bank response.

When placing test orders you need to activate Test mode in the payment gateway settings and use the merchant and customer credentials displayed below.

Test agent

↑ Back to top

The test system does not share accounts with the live site. A test agent has been set up in place of a live agent account. This agent is approved for both credit card/bank payments and invoice payments.

• API User ID (AgentId): 4
• API Password (MD5-key): 2acab30d-fe50-426f-90d7-8c60a7eb31d4
• Receiver Email: testagent-1@payson.se

Test credit card

↑ Back to top

Any card with a valid checksum digit and valid prefix will work. In case you do not have a card available a generated card is specified below.

• Card number: 4581 1111 1111 1112
• Expiration date: Any
• CVC/CVV: Any

FAQ

↑ Back to top

Q. When I try to place an order and proceed to the Payson payment window, I get the following message:

{"result":"failure","messages":"","refresh":"false"}

What is wrong?

A. Most often this error appears because you are trying to purchase using the same email address as the registered Payson seller email. Payson interprets this as the seller and the buyer being the same person.

---

Q. I receive this error message when trying to order multiples of one product:

array ( 0 => PaysonApiError::__set_state(array( 'errorId' => '590001', 'message' => 'The total amount specified for receivers does not match the total amount specified by the order items.', 'parameter' => 'orderItemList+receiverList', )), )

What is wrong?

A. This error concerns only the Payson Invoice feature in the extension. You need to have your store’s number of decimals set to “2” to work with tax calculations.

You will find the setting in your WP Admin by navigating to WooCommerce > Settings > General > Number of Decimals.

If you do not wish to display decimals in your prices, we recommend using the snippet below in your functions.php file (or via a separate plugin/extension):

/**
* Trim zeros in price decimals
**/
add_filter( 'woocommerce_price_trim_zeros', '__return_true' );