11# Omnipay: Sage Pay
22
3- ** Sage Pay driver for the Omnipay PHP payment processing library**
3+ ** Sage Pay/Opayo driver for the Omnipay PHP payment processing library**
44
55[ ![ Unit Tests] ( https://github.com/thephpleague/omnipay-sagepay/actions/workflows/run-tests.yml/badge.svg )] ( https://github.com/thephpleague/omnipay-sagepay/actions/workflows/run-tests.yml )
66[ ![ Latest Stable Version] ( https://poser.pugx.org/omnipay/sagepay/version.png )] ( https://packagist.org/packages/omnipay/sagepay )
@@ -14,6 +14,11 @@ This version supports PHP ^7.3 and PHP ^8.
1414This is the ` master ` branch of Omnipay, handling Omnipay version ` 3.x ` .
1515For the ` 2.x ` branch, please visit https://github.com/thephpleague/omnipay-sagepay/tree/2.x
1616
17+ From version 4.1.1 the new Opayo URLs are used in place of the old Sage Pay URLs.
18+ These new URLs will be mandatory from March 2023, so you must upgrade by then.
19+ The upgrade 4.0 to 4.1.1 should be seamless; all classes remain in the
20+ ` Omnipay\SagePay ` namespace.
21+
1722Table of Contents
1823=================
1924
@@ -965,7 +970,7 @@ or not, so can be used multiple times.
965970
966971# Basket format
967972
968- Sagepay currently supports two different formats for sending cart/item information to them:
973+ Sagepay currently supports two different formats for sending cart/item information to them:
969974 - [ BasketXML] ( http://www.sagepay.co.uk/support/12/36/protocol-3-00-basket-xml )
970975 - [ Basket] ( http://www.sagepay.co.uk/support/error-codes/3021-invalid-basket-format-invalid )
971976
@@ -985,28 +990,28 @@ The Basket format can be used for Sage 50 Accounts Software Integration:
985990> reconcile the transactions on your account within your financial software.
986991> If you wish to link a transaction to a specific product record this can be done through the Basket field
987992 in the transaction registration post.
988- > Please note the following integration is not currently available when using BasketXML fields.
993+ > Please note the following integration is not currently available when using BasketXML fields.
989994> In order for the download of transactions to affect a product record the first entry in a basket line needs
990995 to be the product code of the item within square brackets. For example:
991-
996+
992997```
9939984:[PR001]Pioneer NSDV99 DVD-Surround Sound System:1:424.68:74.32:499.00:499.00
994999```
9951000
9961001You can either prepend this onto the description or using ` \Omnipay\SagePay\Extend\Item ` you can use ` setProductCode `
997- which will take care of pre-pending ` [] ` for you.
1002+ which will take care of pre-pending ` [] ` for you.
9981003
9991004# Account Types
10001005
10011006Your Sage Pay account will use separate merchant accounts for difference transaction sources.
10021007The sources are specified by the ` accountType ` parameter, and take one of three values:
10031008
1004- * "E" Omnipay\SagePay\Message\AbstractRequest::ACCOUNT_TYPE_E (default)
1009+ * "E" Omnipay\SagePay\Message\AbstractRequest::ACCOUNT_TYPE_E (default)
10051010 For ecommerce transactions, entered in your application by the end user.
1006- * "M" Omnipay\SagePay\Message\AbstractRequest::ACCOUNT_TYPE_M
1011+ * "M" Omnipay\SagePay\Message\AbstractRequest::ACCOUNT_TYPE_M
10071012 MOTO transactions taken by telephone or postal forms or faxes, entered by an operator.
10081013 The operator may ask for a CVV when taking a telephone order.
1009- * "C" Omnipay\SagePay\Message\AbstractRequest::ACCOUNT_TYPE_C
1014+ * "C" Omnipay\SagePay\Message\AbstractRequest::ACCOUNT_TYPE_C
10101015 For repeat transactions, generated by the merchant site without any human intervention.
10111016
10121017The "M" MOTO and "C" account types will also disable any 3D-Secure validation that may
@@ -1048,5 +1053,5 @@ If you believe you have found a bug, please report it using the [GitHub issue tr
10481053or better yet, fork the library and submit a pull request.
10491054
10501055#References
1051- - [ Sage pay tokens using token management] ( https://www.opayo.co.uk/file/1171 /download-document/sagepaytokensystemprotocolandintegrationguidelinev3.0_0 .pdf )
1056+ - [ Sage pay tokens using token management] ( https://www.opayo.co.uk/file/2501 /download-document/Token_System_Integration_and_Protocol_Guidelines3.00 .pdf )
10521057- [ Other sage pay transaction types for Server method] ( https://developer-eu.elavon.com/docs/opayo-shared-api )
0 commit comments