Products

List products

get

https://emea.gsc.verifone.cloud/oidc/paypal-ecomhttps://us.gsc.verifone.cloud/oidc/paypal-ecomhttps://nz.gsc.verifone.cloud/oidc/paypal-ecomhttps://cst.test-gsc.vfims.com/oidc/paypal-ecomhttps://uscst.gb.gsc.cficloud/oidc/paypal-ecom

/products

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

paymentProviderContractstringRequired

PayPal Payment Provider Contract UUID

pageSizeinteger · min: 1 · max: 20Optional

The number of items to return in the response.

pageinteger · min: 1 · max: 100000Optional

A non-zero integer which is the start index of the entire list of items that are returned in the response. So, the combination of page=1 and page_size=20 returns the first 20 items. The combination of page=2 and page_size=20 returns the next 20 items.

totalRequiredbooleanOptional

Indicates whether to show the total items and total pages in the response.

Responses

200

Successful

application/json

totalItemsintegerOptional

totalPagesintegerOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/products

HTTPcURLJavaScriptPython

GET /oidc/paypal-ecom/products?paymentProviderContract=text HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalItems": 1,
  "totalPages": 1,
  "products": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "type": "PHYSICAL",
      "category": "AUTO_RENTALS",
      "createdAt": "2026-06-13",
      "updatedAt": "2026-06-13",
      "imageUrl": "text",
      "homeUrl": "text"
    }
  ]
}

Create product

post

https://emea.gsc.verifone.cloud/oidc/paypal-ecomhttps://us.gsc.verifone.cloud/oidc/paypal-ecomhttps://nz.gsc.verifone.cloud/oidc/paypal-ecomhttps://cst.test-gsc.vfims.com/oidc/paypal-ecomhttps://uscst.gb.gsc.cficloud/oidc/paypal-ecom

/products

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

x-vfi-api-idempotencyKeystringOptional

A value you specify that uniquely identifies the transaction. If you're unsure whether a particular transaction succeeded, you can reattempt it with the same idempotency key without worrying about duplicating the transaction.

Body

*/*

paymentProviderContractstringRequired

PayPal Payment Provider Contract UUID

idstring · min: 6 · max: 50Optional

The ID of the product. You can specify the SKU for the product. If you omit the ID, the system generates it. System-generated IDs have the PROD- prefix

namestring · min: 1 · max: 127Required

The product name

descriptionstring · min: 1 · max: 256Optional

The product description

typestring · enumRequired

The product type. Indicates whether the product is physical or tangible goods, or a service

Example: PHYSICALPossible values:

categorystring · enumOptional

The product category

Example: AUTO_RENTALSPossible values:

imageUrlstring · min: 1 · max: 2000Optional

The home page URL for the product

homeUrlstring · min: 1 · max: 2000Optional

The image URL for the product

Responses

201

Created

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

/products

HTTPcURLJavaScriptPython

POST /oidc/paypal-ecom/products HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: */*
Accept: */*
Content-Length: 160

{
  "paymentProviderContract": "text",
  "id": "text",
  "name": "text",
  "description": "text",
  "type": "PHYSICAL",
  "category": "AUTO_RENTALS",
  "imageUrl": "text",
  "homeUrl": "text"
}

{
  "id": "text",
  "name": "text",
  "description": "text",
  "type": "PHYSICAL",
  "category": "AUTO_RENTALS",
  "imageUrl": "text",
  "homeUrl": "text",
  "createdAt": "2026-06-13",
  "updatedAt": "2026-06-13"
}

Get product details

get

https://emea.gsc.verifone.cloud/oidc/paypal-ecomhttps://us.gsc.verifone.cloud/oidc/paypal-ecomhttps://nz.gsc.verifone.cloud/oidc/paypal-ecomhttps://cst.test-gsc.vfims.com/oidc/paypal-ecomhttps://uscst.gb.gsc.cficloud/oidc/paypal-ecom

/products/{id}

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The product ID.

Query parameters

paymentProviderContractstringRequired

PayPal Payment Provider Contract UUID

Responses

200

Successful

application/json

idstring · min: 6 · max: 50Optional

The ID of the product. You can specify the SKU for the product. If you omit the ID, the system generates it. System-generated IDs have the PROD- prefix

namestring · min: 1 · max: 127Required

The product name

descriptionstring · min: 1 · max: 256Optional

The product description

typestring · enumRequired

The product type. Indicates whether the product is physical or tangible goods, or a service

Example: PHYSICALPossible values:

categorystring · enumOptional

The product category

Example: AUTO_RENTALSPossible values:

imageUrlstring · min: 1 · max: 2000Optional

The home page URL for the product

homeUrlstring · min: 1 · max: 2000Optional

The image URL for the product

createdAtstring · dateRequired

Product creation date (ISO-8601)

updatedAtstring · dateRequired

Product last update date (ISO-8601)

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/products/{id}

HTTPcURLJavaScriptPython

GET /oidc/paypal-ecom/products/{id}?paymentProviderContract=text HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "description": "text",
  "type": "PHYSICAL",
  "category": "AUTO_RENTALS",
  "imageUrl": "text",
  "homeUrl": "text",
  "createdAt": "2026-06-13",
  "updatedAt": "2026-06-13"
}

Update product

patch

https://emea.gsc.verifone.cloud/oidc/paypal-ecomhttps://us.gsc.verifone.cloud/oidc/paypal-ecomhttps://nz.gsc.verifone.cloud/oidc/paypal-ecomhttps://cst.test-gsc.vfims.com/oidc/paypal-ecomhttps://uscst.gb.gsc.cficloud/oidc/paypal-ecom

/products/{id}

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The product ID.

Body

*/*

paymentProviderContractstringRequired

PayPal Payment Provider Contract UUID

Responses

204

No Content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

patch

/products/{id}

HTTPcURLJavaScriptPython

PATCH /oidc/paypal-ecom/products/{id} HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: */*
Accept: */*
Content-Length: 200

{
  "paymentProviderContract": "text",
  "imageUrl": {
    "op": "add",
    "value": "text"
  },
  "homeUrl": {
    "op": "add",
    "value": "text"
  },
  "category": {
    "op": "add",
    "value": "AUTO_RENTALS"
  },
  "description": {
    "op": "add",
    "value": "text"
  }
}

No content