Documentation / API / Operations on Payment Methods

GET and COUNT operations available on payment methods.

Payment Methods Operations

GET

URL

POST https://your-secured-store-url:443/api/v1/payments/methods/get

Filters

Filter Type
id Array of GUID
name Array of String (max 255 chars)
type Array of String (Predefined values)
appliesto Array of String (Predefined values)
appliestocountryid Array of GUID (Countries)
createdon_min DateTime
createdon_max DateTime

Request

Retrieve all the items (max 1000)

{
        'authentication' : {
            'apiKey' : 'jjns7519v1v3ns6xU162'
        }
    }

Retrieve specific items by ID

{
        'authentication' : {
            'apiKey' : 'jjns7519v1v3ns6xU162'
        },
        'filters' : {
            'id' : ['00000000-0000-0000-0000-000000000000', '12345678-1234-1234-1234-123456781234']
        }
    }

Most complete request (just to give you the format of each parameter)

{
        'authentication' : {
            'apiKey' : 'jjns7519v1v3ns6xU162'
        },
        'filters' : {
            'id': ['00000000-0000-0000-0000-000000000000', '12345678-1234-1234-1234-123456781234'],
		    'name' : ['Payment 1', 'Payment 2'],
		    'type' : ['WIRE'],
		    'appliesto' : ['EVERYWHERE'],
		    'appliestocountryid' : ['75b36fa9-4eb5-4a2f-8bd2-2baafd81cfe9'],
		    'createdon_min' : '2015-01-01',
		    'createdon_max' : '2042-01-01'
        },
        'pagination' : {
            'pageNumber' : '1',
            'pageSize' : '1000'
        }
    }

Response

If no error occured, you will receive a response like this one (object type: Payment Method). Please refer to error messages to learn more about the possible error responses.

[
   {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Payment 1",
      "type": "WIRE",
      "appliesto": "EVERYWHERE",
      "appliestocountryid": "75b36fa9-4eb5-4a2f-8bd2-2baafd81cfe9",
      "appliestocountrycode": "CA",
      "appliestocountryname": "Canada",
      "appliestolist": [
         ""
      ],
      "instant": {},
      "author": "Mr Example",
      "createdon": "2016-01-07 14:00:22"
   },
    {
      "id": "381f23e5-1a3a-4912-8ec1-4e0a8d212618",
      "name": "Payment 2",
      "type": "WIRE",
      "appliesto": "EVERYWHERE",
      "appliestocountryid": "75b36fa9-4eb5-4a2f-8bd2-2baafd81cfe9",
      "appliestocountrycode": "CA",
      "appliestocountryname": "Canada",
      "appliestolist": [
         ""
      ],
      "instant": {},
      "author": "Mr Example",
      "createdon": "2016-01-07 14:00:22"
   }
]

COUNT

URL

POST https://your-secured-store-url:443/api/v1/payments/methods/count

Filters

Filter Type
id Array of GUID
name Array of String (max 255 chars)
type Array of String (Predefined values)
appliesto Array of String (Predefined values)
appliestocountryid Array of GUID (Countries)
createdon_min DateTime
createdon_max DateTime

Request

Count the items

{
        'authentication' : {
            'apiKey' : 'jjns7519v1v3ns6xU162'
        }
    }

Count specific items by country

{
        'authentication' : {
            'apiKey' : 'jjns7519v1v3ns6xU162'
        },
        'filters' : {
            'appliestocountryid' : ['75b36fa9-4eb5-4a2f-8bd2-2baafd81cfe9']
        }
    }

Most complete request (just to give you the format of each parameter)

{
        'authentication' : {
            'apiKey' : 'jjns7519v1v3ns6xU162'
        },
        'filters' : {
            'id': ['00000000-0000-0000-0000-000000000000', '12345678-1234-1234-1234-123456781234'],
		    'name' : ['Payment 1', 'Payment 2'],
		    'type' : ['WIRE'],
		    'appliesto' : ['EVERYWHERE'],
		    'appliestocountryid' : ['75b36fa9-4eb5-4a2f-8bd2-2baafd81cfe9'],
		    'createdon_min' : '2015-01-01',
		    'createdon_max' : '2042-01-01'
        }
    }

Response

If no error occured, you will receive a response like this one. Please refer to error messages to learn more about the possible error responses.

{
   "count": "2"
}