---
title: PaymentCustomization - GraphQL Admin
description: A payment customization.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentCustomization
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentCustomization.md
---

# Payment​Customization

object

Requires `read_payment_customizations` access scope.

A payment customization.

## Fields

* enabled
* errorHistory
* functionId
* id
* metafield
* metafields
* shopifyFunction
* title
* metafieldDefinitions: deprecated

***

## Map

### Fields and connections with this object

* [PaymentCustomizationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/PaymentCustomizationConnection#returns-nodes)
* [PaymentCustomizationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentCustomizationEdge#field-PaymentCustomizationEdge.fields.node)

### Possible type in

* [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer)

***

## Queries

* paymentCustomization
* paymentCustomizations

***

## PaymentCustomization Queries

### Queried by

* [payment​Customization](https://shopify.dev/docs/api/admin-graphql/latest/queries/paymentCustomization)
* [payment​Customizations](https://shopify.dev/docs/api/admin-graphql/latest/queries/paymentCustomizations)

***

## Mutations

* paymentCustomizationCreate
* paymentCustomizationUpdate

***

## PaymentCustomization Mutations

### Mutated by

* [payment​Customization​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/paymentCustomizationCreate)
* [payment​Customization​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/paymentCustomizationUpdate)

***

## Interfaces

* HasMetafieldDefinitions
* HasMetafields
* Node

***

## PaymentCustomization Implements

### Implements

* [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions)
* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)