---
title: "Update Actor's Payment Methods"
method: PUT
path: "/v1/actors/{ActorID}/paymentMethods"
tags: ["Actors"]
---

# Update Actor's Payment Methods

`PUT /v1/actors/{ActorID}/paymentMethods`

Updates the payment methods associated with a specific actor, identified by the `ActorID`.

## Path parameters

- `ActorID` integer, required

## Request body

- ActorPaymentResponse[]
  - `ActorID` integer — The unique identifier of the actor.
  - `PaymentMethodID` integer — The identifier of the payment method associated with the actor.
  - `ExtraChargePercentageBit` boolean, nullable — Indicates whether an extra charge is calculated as a percentage of the transaction.
  - `ExtraChargeValue` number, double — The value of the extra charge applied to transactions.
  - `LastUpdated` string, date-time, nullable — The date and time when the payment method details were last updated.
  - `ExternalPaymentProviderURL` string, nullable — The URL of the external payment provider, if applicable.
  - `ExternalPaymentProviderID` integer, nullable — The identifier of the external payment provider.
  - `ExternalPaymentProviderModeID` integer, nullable — The mode identifier of the external payment provider (e.g., test, production).
  - `ExternalPaymentProviderUsername` string, nullable — The username used for authentication with the external payment provider.
  - `ExternalPaymentProviderPassword` string, nullable — The password used for authentication with the external payment provider.
  - `ExternalPaymentProviderMerchantID` string, nullable — The merchant identifier used by the external payment provider.
  - `ExternalPaymentProviderKey` string, nullable — The key used by the external payment provider for transaction processing.
  - `ExternalPaymentProviderAppID` string, nullable — The application identifier used by the external payment provider.
  - `ExternalPaymentProviderCertificatePath` string, nullable — The file path to the certificate used by the external payment provider.
  - `ExternalPaymentProviderCertificatePassword` string, nullable — The password for the external payment provider's certificate.
  - `ExternalPaymentProviderApiKey` string, nullable — The API key used by the external payment provider.
  - `ExternalPaymentProviderLocationIdentifier` string, nullable — The location identifier used by the external payment provider.
  - `PaymentMethodWorkingDays` WorkDay[], nullable — The working days and hours during which the payment method is available.
    - `name` string, nullable — The name of the workday (e.g., Monday, Holiday).
    - `week_day` integer, nullable — The day of the week represented as an integer (e.g., 1 for Monday, 7 for Sunday).
    - `start_time` string, date-span, nullable — The start time of the working hours for the payment method.
    - `end_time` string, date-span, nullable — The end time of the working hours for the payment method.
    - `work_hour_lut_id` integer, nullable — The lookup identifier for the work hours associated with the payment method.
  - `PaymentMethodCustomData` string, nullable — Custom data associated with the payment method, if any.
  - `ExtraChargeBackupValue` number, double — The backup value of the extra charge applied to transactions.
  - `ChargeMachineID` integer, nullable — The identifier of the machine where charges are processed, if applicable.

## Response `200`

The payment methods were updated successfully.

- ActorPaymentResponse[]
  - `ActorID` integer — The unique identifier of the actor.
  - `PaymentMethodID` integer — The identifier of the payment method associated with the actor.
  - `ExtraChargePercentageBit` boolean, nullable — Indicates whether an extra charge is calculated as a percentage of the transaction.
  - `ExtraChargeValue` number, double — The value of the extra charge applied to transactions.
  - `LastUpdated` string, date-time, nullable — The date and time when the payment method details were last updated.
  - `ExternalPaymentProviderURL` string, nullable — The URL of the external payment provider, if applicable.
  - `ExternalPaymentProviderID` integer, nullable — The identifier of the external payment provider.
  - `ExternalPaymentProviderModeID` integer, nullable — The mode identifier of the external payment provider (e.g., test, production).
  - `ExternalPaymentProviderUsername` string, nullable — The username used for authentication with the external payment provider.
  - `ExternalPaymentProviderPassword` string, nullable — The password used for authentication with the external payment provider.
  - `ExternalPaymentProviderMerchantID` string, nullable — The merchant identifier used by the external payment provider.
  - `ExternalPaymentProviderKey` string, nullable — The key used by the external payment provider for transaction processing.
  - `ExternalPaymentProviderAppID` string, nullable — The application identifier used by the external payment provider.
  - `ExternalPaymentProviderCertificatePath` string, nullable — The file path to the certificate used by the external payment provider.
  - `ExternalPaymentProviderCertificatePassword` string, nullable — The password for the external payment provider's certificate.
  - `ExternalPaymentProviderApiKey` string, nullable — The API key used by the external payment provider.
  - `ExternalPaymentProviderLocationIdentifier` string, nullable — The location identifier used by the external payment provider.
  - `PaymentMethodWorkingDays` WorkDay[], nullable — The working days and hours during which the payment method is available.
    - `name` string, nullable — The name of the workday (e.g., Monday, Holiday).
    - `week_day` integer, nullable — The day of the week represented as an integer (e.g., 1 for Monday, 7 for Sunday).
    - `start_time` string, date-span, nullable — The start time of the working hours for the payment method.
    - `end_time` string, date-span, nullable — The end time of the working hours for the payment method.
    - `work_hour_lut_id` integer, nullable — The lookup identifier for the work hours associated with the payment method.
  - `PaymentMethodCustomData` string, nullable — Custom data associated with the payment method, if any.
  - `ExtraChargeBackupValue` number, double — The backup value of the extra charge applied to transactions.
  - `ChargeMachineID` integer, nullable — The identifier of the machine where charges are processed, if applicable.

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/versions/421f6f83c257/schema)
