Get a list of filtered payments – Nuvei Documentation

You can specify various filters as parameters in the query string in order to get a customized list of payments. This type of request allows you to get a list of payments according to your own needs and requirements, simplifying the process of finding transactions.

You can get a list of paginated payments by adding the pageSize and pageIndex parameters to the URL. The pageIndex parameter is recommended to be used together with the pageSize parameter to select the number of transactions on a specific page.

The following table describes all the filters that you can use. Please note that you can mix the filters to get specific results.

FILTERS
Field	Description	Data type
pageSize	The maximum number of transactions that will be returned per page. The pageSize parameter used together with the pageIndex parameter will also represent the number of transactions returned for a specific page. Please note that without specifying any parameter the default number of transactions that will be returned is 50!	Long
Request:	`GET https://paytest.smart2pay.com/v1/payments?pagesize=20&pageindex=3`
pageIndex	Using the pageIndex parameter you will be able to receive the transactions paginated. The default number of transactions that will be returned per page is 50. Transactions are ordered by ID descending. The pageIndex parameter is recommended to be used together with the pageSize parameter in order to choose the desired number of transactions returned per page.	Long
Request:	`GET https://paytest.smart2pay.com/v1/payments?pagesize=20&pageindex=3`
sortDirection	By default, the transactions are ordered by ID descending. By using the sortDirection parameter, you have the possibility to order the transactions by ID ascending (sortdirection=asc).	String
Request:	`GET https://paytest.smart2pay.com/v1/payments?pagesize=20&pageindex=3&sortdirection=asc`
sortBy	By default, the transactions are ordered by ID descending. By using the sortBy parameter you will be able to receive the transactions sorted after merchanttransactionid / inputdatetime / amount in combination with sortDirection (=asc / =desc) parameter.	Long
Request:	`GET https://paytest.smart2pay.com/v1/payments?pagesize=20&pageindex=3&sortby=amount&sortdirection=asc`
startDate	The date and time after which the payments are returned.	DateTime YYYYMMDDHHMMSS
Request:	`GET https://paytest.smart2pay.com/v1/payments?startDate=20170803150000`
endDate	The date and time until which the payments are returned.	DateTime YYYYMMDDHHMMSS
Request:	`GET https://paytest.smart2pay.com/v1/payments?startDate=20170803150000&endDate=20171003140000`
methodID	Only the transactions having this methodID will be returned.	Long
Request:	`GET https://paytest.smart2pay.com/v1/payments?methodID=2`
country	Only the transactions having this country code will be returned.	String (ISO 3166-1-alpha-2)
Request:	`GET https://paytest.smart2pay.com/v1/payments?country=NL`
currency	Only the transactions having this currency code will be returned.	String (ISO 4217)
Request:	`GET https://paytest.smart2pay.com/v1/payments?currency=EUR`
minimumAmount	Only the payments with an amount higher than this will be returned.	Integer (last 2 digits representing the decimal part)
Request:	`GET https://paytest.smart2pay.com/v1/payments?minimumAmount=100`
maximumAmount	Only the payments with an amount lower than this will be returned.	Integer (last 2 digits representing the decimal part)
Request:	`GET https://paytest.smart2pay.com/v1/payments?maximumAmount=1000`
merchantTransactionID	Only the payment having this merchantTransactionID will be returned.	String ^[0-9a-zA-Z_-]{1,50}$
Request:	`GET https://paytest.smart2pay.com/v1/payments?merchantTransactionID=123456`
statusID	Only the transactions having this statusID will be returned.	Integer The ID of the payment status can have the following values: 1 – Open, 2 – Success, 3 – Cancelled, 4 – Failed, 5 – Expired, 9 – Authorized.
Request:	`GET https://paytest.smart2pay.com/v1/payments?statusID=2`
methodTransactionID	Only the payments having this methodTransactionID will be returned. This transaction ID from the payment method provider can be used for customer support.	String ^[0-9a-zA-Z_-]{1,50}$
Request:	`GET https://paytest.smart2pay.com/v1/payments?methodTransactionID=100200`
typeID	Only the transactions having this typeID will be returned.	Integer The typeID filter can have the following values: 1 – Payments, 2 – Recurring payments.
Request:	`GET https://paytest.smart2pay.com/v1/payments?typeID=1`

Here is an example request where the transactions are divided in pages (groups of transactions) of 2 transactions and the third group of transactions is returned.

Request:

GET https://paytest.smart2pay.com/v1/payments?pagesize=2&pageindex=3

Response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"Payments": [
  {
   "ID": 2459122,
   "SkinID": null, 
   "Created": "20160411140447",
   "MerchantTransactionID": "WPD_1460383484_8795_5000",
   "Amount": "100",
   "Currency": "BAM",
   "CapturedAmount": null,
   "ReturnURL": "https://docs-apm.nuvei.com/wp-content/plugins/smart2pay-api/views/funcs/demo_clean_return.php",
   "Description": null,
   "MethodID": 79,
   "MethodOptionID": null,
   "IncludeMethodIDs": null,
   "ExcludeMethodIDs": null,
   "PrioritizeMethodIDs": null,
   "SiteID": 30201,
   "NotificationDateTime": "20160411140522",
   "Customer": null,
   "BillingAddress": null,
   "ShippingAddress": null,
   "Articles": null,
   "Details": null,
   "ReferenceDetails": null,
   "CustomParameters": null,
   "PreapprovalID": null,
   "Status": {
     "ID": 1,
     "Info": "Open",
     "Reasons": null
   },
   "MethodTransactionID": null,
   "TokenLifetime": null,
   "Capture": null,
   "RedirectURL": null
   },
   {
   "ID": 2459118,
   "SkinID": null,
   "Created": "20160411125607",
   "MerchantTransactionID": "WPD_1460379365_1783_6355",
   "Amount": "1100",
   "Currency": "NGN",
   "CapturedAmount": null,
   "ReturnURL": "https://docs-apm.nuvei.com/wp-content/plugins/smart2pay-api/views/funcs/demo_clean_return.php",
   "Description": null,
   "MethodID": null,
   "MethodOptionID": null,
   "IncludeMethodIDs": null,
   "ExcludeMethodIDs": null,
   "PrioritizeMethodIDs": null,
   "SiteID": 30201,
   "NotificationDateTime": "20160411125629",
   "Customer": null,
   "BillingAddress": null,
   "ShippingAddress": null,
   "Articles": null,
   "Details": null,
   "ReferenceDetails": null,
   "CustomParameters": null,
   "PreapprovalID": null,
   "Status": {
     "ID": 3,
     "Info": "Cancelled",
     "Reasons": null
       },
   "MethodTransactionID": null,
   "TokenLifetime": null,
   "Capture": null,
   "PreapprovalDetails": null,
   "RedirectURL": null
    }
  ],
   "TotalPages": 50,
   "PageSize": 2,
   "PageIndex": 3,
   "Count": 2,
   "TotalCount": 100
}

{"Payments":{"hint":"","regexp":"","type":"array of objects","ID":{"hint":"GlobalPay transaction ID, a unique number that identifies the transaction in the GlobalPay system.","regexp":"^\\d{1,12}$","type":"int"},"SkinID":{"hint":"Skin ID to be used","regexp":"^\\d{1,12}$","type":"int"},"ClientIP":{"hint":"The IP address of the customer","regexp":"^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$","type":"string"},"Created":{"hint":"Date and time when the transaction was created in GlobalPay system.","regexp":"","type":"datetime"},"MerchantTransactionID":{"hint":"Merchant Transaction ID, a number that uniquely identifies a transaction in your system.","regexp":"^[0-9a-zA-Z_-]{1,50}$","type":"string"},"OriginatorTransactionID":{"hint":"Originator transaction ID, a number that uniquely identifies the transaction in the original requester\u2019s system.","regexp":"^[0-9a-zA-Z_-]{1,50}$","type":"string"},"Amount":{"hint":"The service(s)\/product(s) price on your website or application. The last two digits represent the decimal part (11.54 will be sent 1154).","regexp":"^\\d{1,12}$","type":"int"},"Currency":{"hint":"The currency in which you sell the services or products. Format is according to ISO 4217, a three-letter code.","regexp":"^[A-Z]{3}$","type":"string"},"CapturedAmount":{"hint":"The payment\u2018s captured amount. The last two digits represent the decimal part (11.54 will be sent 1154). Please be aware that data type string is also accepted as long as it contains only digits.","regexp":"^\\d{1,12}$","type":"int"},"ReturnURL":{"hint":"An URL at your end where the customer will be redirected after the payment process ends.","regexp":"^(http(s)?(:\\\/\\\/|%3A%2F%2F).+){1,512}$","type":"string"},"Description":{"hint":"Text describing the service or product sold; will be displayed on the payment page.","regexp":"^.{1,255}$","type":"string"},"MethodID":{"hint":"The ID of the payment method.","regexp":"^\\d{1,12}$","type":"int"},"MethodOptionID":{"hint":"The ID of the payment option; can be used when the payment method has multiple payment options (e.g. ING bank is an option for iDEAL).","regexp":"^([0-9]{1,10})$","type":"int"},"IncludeMethodIDs":{"hint":"Methods can be included in this list and will be shown to the customer on the payment page. Subset of Smart2Pay payment methods from the ones assigned to you.","regexp":"","type":"array"},"ExcludeMethodIDs":{"hint":"Excluded methods will be shown to the customer in this list on the payment page. Subset of Smart2Pay payment methods from the ones assigned to you.","regexp":"","type":"array"},"PrioritizeMethodIDs":{"hint":"A sorted list of methods assigned to you. This is the order in which the methods will be displayed in the payment page.","regexp":"","type":"array"},"SiteID":{"hint":"The ID of the site","regexp":"^([0-9]{1,10})$","type":"int"},"NotificationDateTime":{"hint":"Date and time of payment notification","regexp":"","type":"datetime"},"Customer":{"hint":"Customer details","regexp":"","type":"object","ID":{"hint":"Customer ID, a unique number that identifies the customer in the GlobalPay system.","regexp":"^\\d{1,12}$","type":"int"},"MerchantCustomerID":{"hint":"The ID of the customer in your system.","regexp":"^([0-9a-zA-Z_-]{1,50})?$","type":"string"},"Email":{"hint":"Customer\u2019s email","regexp":"^[a-zA-Z0-9\\._%+-]{1,100}@[a-zA-Z0-9\\.-]{1,40}\\.[a-zA-Z]{1,8}$","type":"string"},"FirstName":{"hint":"Customer\u2019s first name","regexp":"","type":"string"},"LastName":{"hint":"Customer\u2019s last name","regexp":"","type":"string"},"Gender":{"hint":"Customer\u2019s gender. It can have the following values: 1 - Male, 2 - Female.","regexp":"","type":"string"},"DateOfBirth":{"hint":"Customer date of birth","regexp":"^(((19|20)\\d\\d)(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01]))$","type":"date"},"SocialSecurityNumber":{"hint":"Customer\u2018s social or fiscal identifier","regexp":"","type":"string"},"Phone":{"hint":"Customer\u2019s phone including prefix","regexp":"","type":"string"},"Company":{"hint":"Company name (for legal entities)","regexp":"","type":"string"},"InputDateTime":{"hint":"Customer creation date","regexp":"","type":"datetime"}},"BillingAddress":{"hint":"Billing Address details","regexp":"","type":"object","ID":{"hint":"Address ID, a unique number that identifies an address in the GlobalPay system.","regexp":"^\\d{1,12}$","type":"int"},"Country":{"hint":"Customer\u2018s country. Recommended to be sent in order to increase the conversion. If MethodID is missing, this field (taken from BillingAddress object) controls which payment methods are shown on the hosted payment pages. Format is according to ISO-3166-1 alpha-2, a two-letter code.","regexp":"^([A-Za-z]{2})?$","type":"string"},"City":{"hint":"City name","regexp":"^(.{1,255})?$","type":"string"},"ZipCode":{"hint":"Postal code","regexp":"^(.{1,255})?$","type":"string"},"State":{"hint":"State name","regexp":"^(.{1,255})?$","type":"string"},"Street":{"hint":"Street name","regexp":"^(.{1,255})?$","type":"string"},"StreetNumber":{"hint":"Street Number","regexp":"^(.{1,255})?$","type":"string"},"HouseNumber":{"hint":"House Number","regexp":"^(.{1,255})?$","type":"string"},"HouseExtension":{"hint":"House Extension","regexp":"^(.{1,255})?$","type":"string"}},"ShippingAddress":{"hint":"Shipping Address details","regexp":"","type":"object","ID":{"hint":"Address ID, a unique number that identifies an address (where you want your items delivered) in the GlobalPay system.","regexp":"^\\d{1,12}$","type":"int"},"Country":{"hint":"Shipping country, where your customer\u2018s items should be delivered. It can be the same as the customer\u2018s billing address, or it can be different. Format is according to ISO-3166-1 alpha-2, a two-letter code.","regexp":"^([A-Za-z]{2})?$","type":"string"},"City":{"hint":"City name","regexp":"^(.{1,255})?$","type":"string"},"ZipCode":{"hint":"Postal code","regexp":"^(.{1,255})?$","type":"string"},"State":{"hint":"State name","regexp":"^(.{1,255})?$","type":"string"},"Street":{"hint":"Street name","regexp":"^(.{1,255})?$","type":"string"},"StreetNumber":{"hint":"Street Number","regexp":"^(.{1,255})?$","type":"string"},"HouseNumber":{"hint":"House Number","regexp":"^(.{1,255})?$","type":"string"},"HouseExtension":{"hint":"House Extension","regexp":"^(.{1,255})?$","type":"string"}},"Articles":{"hint":"The services\/products purchased from the website. Mandatory to be sent for Klarna Invoice and Klarna Payments payment methods.","regexp":"","type":"array of objects","MerchantArticleID":{"hint":"The ID of the article in your system","regexp":"^\\d{1,19}$","type":"string"},"Name":{"hint":"Article\u2019s name","regexp":"^.{1,250}$","type":"string"},"Quantity":{"hint":"The number of products. If is not sent the default value is 1.","regexp":"^\\d{1,3}$","type":"int"},"Price":{"hint":"The price for one item","regexp":"","type":"int"},"VAT":{"hint":"Value-Added Tax ( it is a tax in percent on the purchase price)","regexp":"^\\d{1,4}$","type":"int"},"Discount":{"hint":"The percent on the original price offered by you as discount. The last two digits represent the decimal part (10% will be sent 1000).","regexp":"^\\d{1,4}$","type":"int"},"DiscountValue":{"hint":"The fixed value on the original price offered by you as discount. The last two digits represent the decimal part (10 GBP will be sent 1000).","regexp":"^\\d{1,4}$","type":"int"},"Type":{"hint":"The type of article. It can have the following values: 4 - Discount, 5 -Physical, 6 - Shipping_fee, 7 - Sales_tax, 8 - Digital, 9 - Gift_card, 10 - Store_credit, 11 - Surcharge.","regexp":"^(1|2|3|4|5|6|7|8|9|10|11)$","type":"int"},"TaxType":{"hint":"The type of tax. It can have the following values: 1 - without VAT, 2 - VAT at the rate of 0%, 3 - VAT of the receipt at the rate of 10%, 4 - VAT of the receipt at the rate of 18%, 5 - VAT of the receipt at the applicable rate of 10\/110, 6 - VAT of the receipt at the applicable rate of 18\/118.","regexp":"^(1|2|3|4|5|6)$","type":"int"}},"Splits":{"hint":"","regexp":"","type":"array of objects","ID":{"hint":"Payment split ID","regexp":"^\\d{1,12}$","type":"int"},"PaymentID":{"hint":"Payment ID","regexp":"^\\d{1,12}$","type":"int"},"SiteID":{"hint":"The ID of the site","regexp":"^\\d{1,12}$","type":"int"},"MerchantTransactionID":{"hint":"Payment merchant assigned transaction ID","regexp":"","type":"string"},"OriginatorTransactionID":{"hint":"Originator transaction ID, a number that uniquely identifies the transaction in the original requester\u2019s system.","regexp":"^[0-9a-zA-Z_-]{1,50}$","type":"string"},"Created":{"hint":"Split payment creation time","regexp":"","type":"datetime"},"Amount":{"hint":"Split payment amount","regexp":"^\\d{1,12}$","type":"int"},"Currency":{"hint":"The currency in which you sell the services or products. Format is according to ISO 4217, a three-letter code.","regexp":"^[A-Z]{3}$","type":"string"},"CapturedAmount":{"hint":"Payment amount captured","regexp":"^\\d{1,12}$","type":"int"},"Status":{"hint":"","regexp":"","type":"object","ID":{"hint":"Status ID","regexp":"","type":"int"},"Info":{"hint":"The description of the status","regexp":"","type":"string"},"Reasons":{"hint":"The reasons why the payment got to this status.","regexp":"","type":"array of objects","Code":{"hint":"The id of the message type transmitted in the response. See our section GlobalPay Return Codes for a complete description.","regexp":"","type":"int"},"Info":{"hint":"The message body","regexp":"","type":"string"}}}},"Details":{"hint":"In some cases we send various details about the payment (e.g. Reference Number and Bank Details of the Customer for Bank Transfer payments).","regexp":"","type":"object","BankCode":{"hint":"Customer\u2019s Bank Code. Also known as BIC or Swift_BIC. Bank Identifier Code (BIC), a unique identification code for a particular bank (consists of 8-11 alphanumeric characters).","regexp":"","type":"string"},"AccountNumber":{"hint":"Account number","regexp":"","type":"string"},"IBAN":{"hint":"IBAN (International Bank Account Number) a code (up to 34 alphanumeric characters) that uniquely identifies an account held at any bank anywhere in the world.","regexp":"","type":"string"},"BIC":{"hint":"Bank Identifier Code (BIC), a unique identification code for a particular bank (consists of 8-11 alphanumeric characters).","regexp":"","type":"string"},"EntityID":{"hint":"Payment entity ID","regexp":"","type":"string"},"ReferenceID":{"hint":"Payment reference ID","regexp":"","type":"string"},"EntityNumber":{"hint":"Payment entity number","regexp":"","type":"string"},"ReferenceNumber":{"hint":"Payment reference number","regexp":"","type":"string"},"AccountHolder":{"hint":"The person whose name is on the bank account.","regexp":"","type":"string"},"BankName":{"hint":"The name of the Bank","regexp":"","type":"string"},"BankSortCode":{"hint":"Bank sort code identifies both the bank and the branch where the account is held (consists of 6 digits).","regexp":"","type":"string"},"SocialSecurityNumber":{"hint":"Payer social security number","regexp":"","type":"string"},"SWIFT_BIC":{"hint":"Swift Code, a standard format of Bank Identifier Codes (BIC), is a unique identification code for a particular bank (consists of 8-11 alphanumeric characters).","regexp":"","type":"string"},"AccountCurrency":{"hint":"The currency in which the account is kept. Format is according to ISO 4217, a three-letter code.","regexp":"","type":"string"},"PrepaidCard":{"hint":"Prepaid card number","regexp":"","type":"string"},"PrepaidCardPIN":{"hint":"Prepaid card PIN","regexp":"","type":"string"},"SerialNumbers":{"hint":"Serial numbers","regexp":"","type":"string"},"Wallet":{"hint":"Customer wallet","regexp":"","type":"string"},"PayerCountry":{"hint":"Payer country ISO 2 characters","regexp":"^[a-zA-Z]{2}$","type":"string"},"PayerEmail":{"hint":"Payer email address","regexp":"^[a-zA-Z0-9\\._%+-]{1,100}@[a-zA-Z0-9\\.-]{1,40}\\.[a-zA-Z]{1,8}$","type":"string"},"PayerPhone":{"hint":"Payer phone number","regexp":"^.{1,20}$","type":"string"},"BillingCycleStart":{"hint":"The date and time when the payment billing cycle starts.","regexp":"","type":"date"},"BillingCycleEnd":{"hint":"The date and time when the payment billing cycle ends.","regexp":"","type":"date"},"UnsubscribeInstructions":{"hint":"Unsubscribe instructions","regexp":"","type":"string"},"CustomerLoginID":{"hint":"Customer login ID","regexp":"","type":"string"},"PaidAmount":{"hint":"Paid amount","regexp":"","type":"int"},"PaidCurrency":{"hint":"Paid currency","regexp":"^[a-zA-Z]{3}$","type":"string"},"ProviderExchangeRate":{"hint":"Provider exchange rate","regexp":"","type":"float"},"PayerBankAccountID":{"hint":"Payer bank account ID","regexp":"","type":"string"},"IsMobileApp":{"hint":"Payment is initiated in a mobile app","regexp":"","type":"bool"},"IsOffline":{"hint":"Offline payment method","regexp":"","type":"bool"},"StoreName":{"hint":"Store name. Can be null only when the store information is verified","regexp":"","type":"string"},"StoreId":{"hint":"Store ID","regexp":"","type":"string"},"TerminalID":{"hint":"Terminal ID","regexp":"","type":"string"}},"CaptureDetails":{"hint":"","regexp":"","type":"object","ID":{"hint":"Capture ID","regexp":"^\\d{1,12}$","type":"int"},"Amount":{"hint":"Capture amount","regexp":"^\\d{1,12}$","type":"int"},"Status":{"hint":"Preapproval ID","regexp":"","type":"object","ID":{"hint":"Status ID","regexp":"","type":"int"},"Info":{"hint":"The description of the status","regexp":"","type":"string"},"Reasons":{"hint":"The reasons why the payment got to this status.","regexp":"","type":"array of objects","Code":{"hint":"The id of the message type transmitted in the response. See our section GlobalPay Return Codes for a complete description.","regexp":"","type":"int"},"Info":{"hint":"The message body","regexp":"","type":"string"}}}},"ReferenceDetails":{"hint":"Reference details structure","regexp":"","type":"object","BankCode":{"hint":"Customer\u2019s Bank Code. Also known as BIC or Swift_BIC. Bank Identifier Code (BIC), a unique identification code for a particular bank (consists of 8-11 alphanumeric characters).","regexp":"","type":"string"},"BankName":{"hint":"The name of the Bank","regexp":"","type":"string"},"EntityID":{"hint":"Entity ID","regexp":"","type":"string"},"EntityNumber":{"hint":"Entity number","regexp":"","type":"string"},"ReferenceID":{"hint":"Reference ID","regexp":"","type":"string"},"ReferenceNumber":{"hint":"Reference number","regexp":"","type":"string"},"SwiftBIC":{"hint":"Swift Code, a standard format of Bank Identifier Codes (BIC), is a unique identification code for a particular bank (consists of 8-11 alphanumeric characters).","regexp":"","type":"string"},"AccountCurrency":{"hint":"The currency in which the account is kept. Format is according to ISO 4217, a three-letter code.","regexp":"","type":"string"},"AccountNumber":{"hint":"Account number","regexp":"","type":"string"},"AccountHolder":{"hint":"The person whose name is on the bank account.","regexp":"","type":"string"},"IBAN":{"hint":"IBAN (International Bank Account Number) a code (up to 34 alphanumeric characters) that uniquely identifies an account held at any bank anywhere in the world.","regexp":"","type":"string"},"AmountToPay":{"hint":"Amount to be paid","regexp":"","type":"string"},"QRCodeURL":{"hint":"QRCode URL","regexp":"","type":"string"},"BoletoURL":{"hint":"Boleto URL","regexp":"","type":"string"},"Instructions":{"hint":"Payment Instructions","regexp":"","type":"string"}},"CustomParameters":{"hint":"We can collect additional information on the payment flow if you instruct our Support Team to configure this feature for you. The data we gather will be notified in this object.","regexp":"","type":"array"},"PreapprovalID":{"hint":"GlobalPay Preapproval ID, a number that uniquely identifies the preapproval in GlobalPay system. You receive it via a notification and it is used to initiate recurring payments.\r\nFor Cards (69) and Klarna Invoice (75), simply send in this field the initial GlobalPay PaymentID received in notification of the initial successful one-off payment that the customer has made.","regexp":"^\\d{1,12}$","type":"int"},"Status":{"hint":"Payment status","regexp":"","type":"object","ID":{"hint":"The ID of the payment status. It can have the following values: 1 - Open, 2 - Success, 3 - Cancelled, 4 - Failed, 5 - Expired, 9 - Authorized.","regexp":"","type":"int"},"Info":{"hint":"The description of the status","regexp":"","type":"string"},"Reasons":{"hint":"The reasons why the payment got to this status.","regexp":"","type":"array of objects","Code":{"hint":"The id of the message type transmitted in the response. See our section GlobalPay Return Codes for a complete description.","regexp":"","type":"int"},"Info":{"hint":"The message body","regexp":"","type":"string"}}},"MethodTransactionID":{"hint":"The Acquirer Reference Number (ARN), a unique number that tags a credit card transaction\/refund when it goes from the merchant bank (the acquiring bank) through the card scheme to the cardholder\\'s bank (the issuer). This number can be used by issuing banks to trace a transaction with an acquirer.","regexp":"","type":"string"},"AuthorizationCode":{"hint":"Acquirer Authorization Code","regexp":"","type":"int"},"Capture":{"hint":"If set to true, the payment will be automatically captured.","regexp":"","type":"bool"},"TokenLifetime":{"hint":"The time in minutes after the token used for redirectURL expires. It defaults to 5 minutes if not sent.","regexp":"^\\d{1,12}$","type":"int"},"PaymentTokenLifetime":{"hint":"The time in minutes after the token used for redirectURL expires. It defaults to 5 minutes if not sent.","regexp":"^\\d{1,12}$","type":"int"},"RedirectInIframe":{"hint":"If set true, the payment page will be shown in an Iframe.","regexp":"","type":"bool"},"RedirectMerchantInIframe":{"hint":"Payment redirect in IFrame","regexp":"","type":"bool"},"RedirectURL":{"hint":"GlobalPay redirect URL, an URL where you need to redirect the customer after you receive the response from the API.","regexp":"^(http(s)?(:\\\/\\\/|%3A%2F%2F).+){1,512}$","type":"string"},"PreapprovalDetails":{"hint":"Preapproval details","regexp":"","type":"object","PreapprovedMaximumAmount":{"hint":"Preapproval maximum amount. Please be aware that data type string is also accepted as long as it contains only digits.","regexp":"^\\d{1,12}$","type":"int"},"MerchantPreapprovalID":{"hint":"Preapproval id provided by merchant","regexp":"","type":"string"},"Frequency":{"hint":"Preapproval frequency \u2013 how often can the customer be billed. It can be onetime\/daily\/weekly\/monthly depending on the country and the mobile carrier.","regexp":"","type":"string"},"PreapprovalDescription":{"hint":"Preapproval description","regexp":"","type":"string"}},"InvalidRequestID":{"hint":"Card failure reference ID","regexp":"","type":"string"},"StatementDescriptor":{"hint":"Statement descriptor","regexp":"","type":"string"},"CreditCardToken":{"hint":"Credit card token structure","regexp":"","type":"object","Value":{"hint":"Token value","regexp":"","type":"string"},"RequireSecurityCode":{"hint":"If set to false when the security code parameter is not used, it will not redirect to the form page to fill in the security code, but the payment will be directly sent to the payment provider.","regexp":"","type":"bool"},"SecurityCode":{"hint":"Token security code","regexp":"","type":"string"}},"Installments":{"hint":"Payment split into installments.\r\nAvailable installments number per country code:\r\nAR: 3, 6, 9, 12;\r\nBR: 2, 3, 4, 5, 6, 10, 12, 15, 18, 24;\r\nCL: 3, 6, 9, 12;\r\nCO: 3, 6, 9, 12, 24, 36;\r\nMX: 3, 6, 9, 12, 18;\r\nPE: 3, 6, 9, 12;\r\nTR: 3, 6, 9, 12.","regexp":"^\\d{1,12}$","type":"int"},"Retry":{"hint":"Should retry payment?","regexp":"","type":"bool"},"3DSecure":{"hint":"To be set to true for Payments using 3DSecure authentication.","regexp":"","type":"bool"},"3DSecureData":{"hint":"Should contain authentication result obtained from your 3DS MPI Provider.","regexp":"","type":"object","AuthenticationStatus":{"hint":"The authentication status value. Possible values: \\\"Y\\\" = successful,\\\"N\\\" = failed.","regexp":"","type":"string"},"ECI":{"hint":"Electronic Commerce Indicator (ECI) is a value that is returned from the Directory Server (Visa, MasterCard and JCB) to indicate the authentication results of your customer\u2018s credit card payment on 3D Secure. ECI Values for Visa: 05, 06, 07; for Mastercard: 00, 01, 02; for JCB: 05, 06, 07.","regexp":"","type":"string"},"CAVV":{"hint":"The Cardholder Authentication Verification Value (CAVV) is a unique value generated by the issuer (or by Visa on the issuer\u2019s behalf) and is passed on to the acquirer to prove that the transaction has been authenticated. The use of CAVV helps secure the integrity of Verified by Visa (VbV) transactions by enabling end-to-end transaction traceability.","regexp":"","type":"string"},"DSID":{"hint":"The Directory Server unique ID assigned for this payment. This can be used for both 3DSecure v2.0 and 3DSecure v1.0. In 3DSecure v1.0 the parameter is known as XID.","regexp":"","type":"string"},"3DSecureVersion":{"hint":"The protocol version of 3D Secure.","regexp":"","type":"string"}},"DeviceInfo":{"hint":"Provides information regarding the customer\u2018s browser.","regexp":"","type":"object","BrowserAcceptHeader":{"hint":"The accept header value of the customer\u2018s browser. This field is required only if the cardholder\u2018s user agent supplied a value.","regexp":"","type":"string"},"BrowserUserAgent":{"hint":"The user agent value of the customer\u2018s browser.","regexp":"","type":"string"},"BrowserJavaEnabled":{"hint":"Boolean value indicating if the customer\u2018s browser is able to execute Java.","regexp":"","type":"bool"},"BrowserJavaScriptEnabled":{"hint":"Boolean value indicating if the customer\u2018s browser is able to execute JavaScript.","regexp":"","type":"bool"},"BrowserLanguage":{"hint":"The customer\u2018s browser language as defined in IETF BCP 47.","regexp":"","type":"string"},"BrowserColorDepth":{"hint":"Contains a value representing the bit depth of the colour palette, in bits per pixel, for displaying images.","regexp":"","type":"int"},"BrowserScreenHeight":{"hint":"Total height of the customer\u2018s screen in pixels.","regexp":"","type":"int"},"BrowserScreenWidth":{"hint":"Total width of the customer\u2018s screen in pixels.","regexp":"","type":"int"},"BrowserTimeZone":{"hint":"Difference between UTC time and the customer\u2018s browser local time in minutes.","regexp":"","type":"int"}},"ScaExemption":{"hint":"Merchant can explicitly apply for an exemption from SCA sending this parameter. Possible values: LowValueTransaction, TransactionRiskAnalysis, MerchantInitiatedTransaction, TrustedBeneficiary, CorporatePayments.","regexp":"","type":"string"},"CardOnFile":{"hint":"CardOnFile transaction details","regexp":"","type":"object","IsInitial":{"hint":"Must be sent \u201ctrue\u201c when the payment is the first in a subsequent payments chain. Must be sent \u201cfalse\u201c when the payment is not the first in a subsequent payments chain.","regexp":"","type":"bool"},"TransactionType":{"hint":"CardOnFile transactions type. Possible values: Installments, Recurring, Reauthorization, Resubmission, Delayed, Incremental, No Show, Others.","regexp":"","type":"string"},"InitialPaymentID":{"hint":"Initial PaymentID of the payment that generated the CardOnFile. This field must be sent when IsInitial field has the value \u201cfalse\u201c. If the field IsInitial has the value \u201ctrue\u201c, the InitialPaymentID should not be sent, but it will be received in the response.","regexp":"","type":"int"}},"Card":{"hint":"Card details","regexp":"","type":"object","HolderName":{"hint":"Card holder name","regexp":"^[^\\d]*$","type":"string"},"Number":{"hint":"Card number","regexp":"^(\\d{16,19})$","type":"string"},"ExpirationMonth":{"hint":"Card expiration month","regexp":"^(0?[1-9]|1[0-2])$","type":"string"},"ExpirationYear":{"hint":"Card expiration year","regexp":"^(20|)([0-9]{2})$","type":"string"},"IssuingBankCountry":{"hint":"Card issuing bank country","regexp":"^[a-zA-Z]{2}$","type":"string"},"SecurityCode":{"hint":"Card security code (CVV2)","regexp":"^([0-9]){3,4}$","type":"string"},"RequireSecurityCode":{"hint":"If set to false when the security code parameter is not used, it will not redirect to the form page to fill in the security code, but the payment will be directly sent to the payment provider.","regexp":"","type":"bool"},"Token":{"hint":"Card token","regexp":"","type":"string"},"MaskedNumber":{"hint":"Card masked number","regexp":"","type":"string"}},"Fraud":{"hint":"Fraud check structure","regexp":"","type":"object","Status":{"hint":"Fraud check status","regexp":"","type":"string"},"CheckMode":{"hint":"Fraud check mode","regexp":"","type":"string"},"Score":{"hint":"Fraud check score","regexp":"","type":"int"},"Reason":{"hint":"Fraud check reason","regexp":"","type":"string"}},"Moto":{"hint":"If set to true, the payment will be marked at the acquirer as Mail Order Telephone Order type of transaction. This is not available for all acquirers.","regexp":"","type":"bool"}},"TotalPages":{"hint":"The total number of pages.","regexp":"","type":"int"},"PageSize":{"hint":"The maximum number of transactions that will be returned per page.","regexp":"","type":"int"},"PageIndex":{"hint":"PageIndex requested; if the PageIndex requested is valid it will be the number of current page.","regexp":"","type":"int"},"Count":{"hint":"The number of transactions on the current page \/ the number of transactions received in the response. Please note that on the last page the Count parameter will refer to the number of the remaining transactions.","regexp":"","type":"int"},"TotalCount":{"hint":"The total number of transactions.","regexp":"","type":"int"},"Error":{"hint":"The description of the error that occurred","regexp":"","type":"string"}}

In the response you will receive additional information in order to keep track of your transactions, like: TotalPages, PageSize, PageIndex, Count and TotalCount.

Here is the example of the request where the transactions are divided in pages (groups of transactions) of 3 transactions and the last group of transactions is returned. In this case the Count parameter will refer to the number of the remaining transactions on the last page.

Request:

GET https://paytest.smart2pay.com/v1/payments?pagesize=3&pageindex=50

Response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
  "Payments": [
    {
      "ID": 3037285,
      "SkinID": null,
      "ClientIP": null,
      "Created": "20170808100902",
      "MerchantTransactionID": "WPD_1502186809_5528_8717",
      "OriginatorTransactionID": null,
      "Amount": "1",
      "Currency": "PHP",
      "CapturedAmount": null,
      "ReturnURL": "https://docs-apm.nuvei.com/wp-content/plugins/smart2pay-api/views/funcs/demo_clean_return.php",
      "Description": null,
      "MethodID": 1029,
      "MethodOptionID": null,
      "IncludeMethodIDs": null,
      "ExcludeMethodIDs": null,
      "PrioritizeMethodIDs": null,
      "SiteID": 30201,
      "NotificationDateTime": "20170808100927",
      "Customer": null,
      "BillingAddress": null,
      "ShippingAddress": null,
      "Articles": null,
      "Details": null,
      "ReferenceDetails": null,
      "CustomParameters": null,
      "PreapprovalID": null,
      "Status": {
        "ID": 3,
        "Info": "Cancelled",
        "Reasons": null
      },
      "MethodTransactionID": null,
      "TokenLifetime": null,
      "Capture": null,
      "PreapprovalDetails": null,
      "RedirectURL": null
    },
    {
      "ID": 3037282,
      "SkinID": null,
      "ClientIP": null,
      "Created": "20170808100848",
      "MerchantTransactionID": "WPD_1502186795_5903_4452",
      "OriginatorTransactionID": null,
      "Amount": "1",
      "Currency": "PHP",
      "CapturedAmount": null,
      "ReturnURL": "https://docs-apm.nuvei.com/wp-content/plugins/smart2pay-api/views/funcs/demo_clean_return.php",
      "Description": null,
      "MethodID": 1051,
      "MethodOptionID": null,
      "IncludeMethodIDs": null,
      "ExcludeMethodIDs": null,
      "PrioritizeMethodIDs": null,
      "SiteID": 30201,
      "NotificationDateTime": null,
      "Customer": null,
      "BillingAddress": null,
      "ShippingAddress": null,
      "Articles": null,
      "Details": null,
      "ReferenceDetails": null,
      "CustomParameters": null,
      "PreapprovalID": null,
      "Status": {
        "ID": 4,
        "Info": "Failed",
        "Reasons": null
      },
      "MethodTransactionID": null,
      "TokenLifetime": null,
      "Capture": null,
      "PreapprovalDetails": null,
      "RedirectURL": null      
        }
     ],
      "TotalPages": 50,
      "PageSize": 3,
      "PageIndex": 50,
      "Count": 2,
      "TotalCount": 149
}

In case of an API error, an HTTP 4xx (you did something wrong) or HTTP 5xx (we did something wrong) response is returned.

For more information about the reasons of a wrong request response see our section GlobalPay Return Codes.

Please note that when a request is initiated with PageIndex filter greater than the TotalPages, an HTTP 4xx status is returned with return code 184: PageIndex Out of Range!

Request:

GET https://paytest.smart2pay.com/v1/payments?pagesize=20&pageindex=500

Response:

HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8

{
  "Payments": [],
  "Count": 0,
  "TotalPages": 178,
  "TotalCount": 3552,
  "PageIndex": 500,
  "PageSize": 20,
  "Error": "PageIndex Out of Range"
}