Jump to

• Request
• Response

Update a third party payment methods

patch

/fscmRestApi/resources/11.13.18.05/publicSectorThirdPartyPayments/{PaymentHeaderKey}/child/ThirdPartyPaymentMethod/{PaymentMethodKey}

Request

Path Parameters

• PaymentHeaderKey(required): integer(int64)
  Identifies the primary key value of the payment.
• PaymentMethodKey(required): integer(int64)
  Identifies payment method key for a record.

Header Parameters

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• PayerAddress: string
  Title: Payer Address

  Maximum Length: 2000

  Identifies the address associated with the payment instrument.
• PayerEmail: string
  Title: Payer Email

  Maximum Length: 480

  Identifies the email associated with the payment instrument.
• PayerName: string
  Title: Payer Name

  Maximum Length: 480

  Identifies the name associated with the payment instrument.
• PaymentAmount: number
  Title: Payment Amount

  Identifies the amount received.
• PaymentCurrency: string
  Maximum Length: 3

  Identifies the payment currency.
• PaymentStatus: string
  Title: Payment Status

  Maximum Length: 30

  Identifies the payment status for a record.
• PaymentTransactionId: string
  Title: Payment Transaction ID

  Maximum Length: 50

  Identifies the reference number associated with the payment instrument.
• PrimaryTrackingData: string
  Title: Primary Tracking Data

  Maximum Length: 100

  Identifies the tracking reference associated with payment.
• SecondaryTrackingData: string
  Title: Secondary Tracking Data

  Maximum Length: 100

  Identifies the tracking reference associated with payment.
• ServiceChargeAmount: number
  Title: Service Charge Amount

  Identifies the service amount charges for a payment.
• TertiaryTrackingData: string
  Title: Tertiary Tracking Data

  Maximum Length: 100

  Identifies the tracking reference associated with payment.
• VoidByName: string
  Title: Void by Name

  Maximum Length: 240

  Identifies the name who voided payment.
• VoidComments: string
  Title: Void Comments

  Maximum Length: 2000

  Identifies the void comments.

{
    "type":"object",
    "properties":{
        "PaymentTransactionId":{
            "title":"Payment Transaction ID",
            "maxLength":"50",
            "type":"string",
            "description":"Identifies the reference number associated with the payment instrument.",
            "nullable":false
        },
        "ServiceChargeAmount":{
            "title":"Service Charge Amount",
            "type":"number",
            "description":"Identifies the service amount charges for a payment.",
            "nullable":false
        },
        "VoidByName":{
            "title":"Void by Name",
            "maxLength":"240",
            "type":"string",
            "description":"Identifies the name who voided payment.",
            "nullable":true
        },
        "PrimaryTrackingData":{
            "title":"Primary Tracking Data",
            "maxLength":"100",
            "type":"string",
            "description":"Identifies the tracking reference associated with payment.",
            "nullable":true
        },
        "PayerAddress":{
            "title":"Payer Address",
            "maxLength":"2000",
            "type":"string",
            "description":"Identifies the address associated with the payment instrument.",
            "nullable":true
        },
        "SecondaryTrackingData":{
            "title":"Secondary Tracking Data",
            "maxLength":"100",
            "type":"string",
            "description":"Identifies the tracking reference associated with payment.",
            "nullable":true
        },
        "PaymentCurrency":{
            "maxLength":"3",
            "type":"string",
            "description":"Identifies the payment currency.",
            "nullable":false
        },
        "PayerName":{
            "title":"Payer Name",
            "maxLength":"480",
            "type":"string",
            "description":"Identifies the name associated with the payment instrument.",
            "nullable":true
        },
        "PayerEmail":{
            "title":"Payer Email",
            "maxLength":"480",
            "type":"string",
            "description":"Identifies the email associated with the payment instrument.",
            "nullable":true
        },
        "PaymentAmount":{
            "title":"Payment Amount",
            "type":"number",
            "description":"Identifies the amount received.",
            "nullable":false
        },
        "VoidComments":{
            "title":"Void Comments",
            "maxLength":"2000",
            "type":"string",
            "description":"Identifies the void comments.",
            "nullable":true
        },
        "TertiaryTrackingData":{
            "title":"Tertiary Tracking Data",
            "maxLength":"100",
            "type":"string",
            "description":"Identifies the tracking reference associated with payment.",
            "nullable":true
        },
        "PaymentStatus":{
            "title":"Payment Status",
            "maxLength":"30",
            "type":"string",
            "description":"Identifies the payment status for a record.",
            "nullable":false
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Body ()

Root Schema : publicSectorThirdPartyPayments-ThirdPartyPaymentMethod-item-response

Type: object

Show Source

• AgencyId: integer (int32)
  Read Only: true

  Default Value: 1

  Identifies the agency id associated with a payment.
• ExternalPaymentReference: string
  Read Only: true

  Maximum Length: 480

  Identifies the payment reference provided by third party payment system.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• PayerAddress: string
  Title: Payer Address

  Maximum Length: 2000

  Identifies the address associated with the payment instrument.
• PayerEmail: string
  Title: Payer Email

  Maximum Length: 480

  Identifies the email associated with the payment instrument.
• PayerName: string
  Title: Payer Name

  Maximum Length: 480

  Identifies the name associated with the payment instrument.
• PaymentAmount: number
  Title: Payment Amount

  Identifies the amount received.
• PaymentCreated: string
  Title: Payment Created

  Read Only: true

  Maximum Length: 30

  Default Value: ORA_CREATED

  Identifies the payment created for a record.
• PaymentCurrency: string
  Maximum Length: 3

  Identifies the payment currency.
• PaymentHeaderId: string
  Read Only: true

  Maximum Length: 50

  Identifies the unique alpha numeric reference of the payment.
• PaymentHeaderKey: integer (int64)
  Read Only: true

  Identifies the primary key value of the payment.
• PaymentHistoryKey: integer (int64)
  Title: Payment History Key

  Read Only: true

  The unique identifier for the payment transaction.
• PaymentMethodCode: string
  Title: Payment Method Code

  Maximum Length: 30

  The method of payment used for a payment transaction, such as credit card, cash, personal check, or cashier???s check.
• PaymentMethodKey: integer (int64)
  Title: Payment Method Key

  Identifies payment method key for a record.
• PaymentReferenceId: string
  Title: Payment Reference ID

  Read Only: true

  Maximum Length: 50

  A reference value created by the payment module and sent as pass-through data to the payment processor.
• PaymentStatus: string
  Title: Payment Status

  Maximum Length: 30

  Identifies the payment status for a record.
• PaymentTransactionId: string
  Title: Payment Transaction ID

  Maximum Length: 50

  Identifies the reference number associated with the payment instrument.
• PrimaryTrackingData: string
  Title: Primary Tracking Data

  Maximum Length: 100

  Identifies the tracking reference associated with payment.
• SecondaryTrackingData: string
  Title: Secondary Tracking Data

  Maximum Length: 100

  Identifies the tracking reference associated with payment.
• ServiceChargeAmount: number
  Title: Service Charge Amount

  Identifies the service amount charges for a payment.
• TertiaryTrackingData: string
  Title: Tertiary Tracking Data

  Maximum Length: 100

  Identifies the tracking reference associated with payment.
• VoidAmount: number
  Read Only: true

  Identifies the void amount.
• VoidByName: string
  Title: Void by Name

  Maximum Length: 240

  Identifies the name who voided payment.
• VoidComments: string
  Title: Void Comments

  Maximum Length: 2000

  Identifies the void comments.
• VoidDatetime: string (date-time)
  Title: Void Date Time

  Read Only: true

  Identifies the void date time.

{
    "type":"object",
    "properties":{
        "PaymentTransactionId":{
            "title":"Payment Transaction ID",
            "maxLength":"50",
            "type":"string",
            "description":"Identifies the reference number associated with the payment instrument.",
            "nullable":false,
            "x-queryable":true
        },
        "PaymentMethodKey":{
            "title":"Payment Method Key",
            "type":"integer",
            "description":"Identifies payment method key for a record.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "AgencyId":{
            "type":"integer",
            "description":"Identifies the agency id associated with a payment.",
            "format":"int32",
            "nullable":true,
            "readOnly":true,
            "default":"1",
            "x-hints":{
                "precision":"8"
            },
            "x-queryable":true
        },
        "ServiceChargeAmount":{
            "title":"Service Charge Amount",
            "type":"number",
            "description":"Identifies the service amount charges for a payment.",
            "nullable":false,
            "x-queryable":true
        },
        "VoidByName":{
            "title":"Void by Name",
            "maxLength":"240",
            "type":"string",
            "description":"Identifies the name who voided payment.",
            "nullable":true,
            "x-queryable":true
        },
        "PrimaryTrackingData":{
            "title":"Primary Tracking Data",
            "maxLength":"100",
            "type":"string",
            "description":"Identifies the tracking reference associated with payment.",
            "nullable":true,
            "x-queryable":true
        },
        "PayerAddress":{
            "title":"Payer Address",
            "maxLength":"2000",
            "type":"string",
            "description":"Identifies the address associated with the payment instrument.",
            "nullable":true,
            "x-queryable":true
        },
        "PaymentCurrency":{
            "maxLength":"3",
            "type":"string",
            "description":"Identifies the payment currency.",
            "nullable":false,
            "x-queryable":true
        },
        "PayerEmail":{
            "title":"Payer Email",
            "maxLength":"480",
            "type":"string",
            "description":"Identifies the email associated with the payment instrument.",
            "nullable":true,
            "x-queryable":true
        },
        "PaymentAmount":{
            "title":"Payment Amount",
            "type":"number",
            "description":"Identifies the amount received.",
            "nullable":false,
            "x-queryable":true
        },
        "PaymentReferenceId":{
            "title":"Payment Reference ID",
            "maxLength":"50",
            "type":"string",
            "description":"A reference value created by the payment module and sent as pass-through data to the payment processor.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "PaymentHeaderId":{
            "maxLength":"50",
            "type":"string",
            "description":"Identifies the unique alpha numeric reference of the payment.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "PaymentCreated":{
            "title":"Payment Created",
            "maxLength":"30",
            "type":"string",
            "description":"Identifies the payment created for a record.",
            "nullable":true,
            "readOnly":true,
            "default":"ORA_CREATED",
            "x-queryable":true
        },
        "PaymentStatus":{
            "title":"Payment Status",
            "maxLength":"30",
            "type":"string",
            "description":"Identifies the payment status for a record.",
            "nullable":false,
            "x-queryable":true
        },
        "SecondaryTrackingData":{
            "title":"Secondary Tracking Data",
            "maxLength":"100",
            "type":"string",
            "description":"Identifies the tracking reference associated with payment.",
            "nullable":true,
            "x-queryable":true
        },
        "ExternalPaymentReference":{
            "maxLength":"480",
            "type":"string",
            "description":"Identifies the payment reference provided by third party payment system.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "PayerName":{
            "title":"Payer Name",
            "maxLength":"480",
            "type":"string",
            "description":"Identifies the name associated with the payment instrument.",
            "nullable":true,
            "x-queryable":true
        },
        "PaymentMethodCode":{
            "title":"Payment Method Code",
            "maxLength":"30",
            "type":"string",
            "description":"The method of payment used for a payment transaction, such as credit card, cash, personal check, or cashier???s check.",
            "nullable":false,
            "x-queryable":true
        },
        "VoidComments":{
            "title":"Void Comments",
            "maxLength":"2000",
            "type":"string",
            "description":"Identifies the void comments.",
            "nullable":true,
            "x-queryable":true
        },
        "VoidAmount":{
            "type":"number",
            "description":"Identifies the void amount.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "PaymentHistoryKey":{
            "title":"Payment History Key",
            "type":"integer",
            "description":"The unique identifier for the payment transaction.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "TertiaryTrackingData":{
            "title":"Tertiary Tracking Data",
            "maxLength":"100",
            "type":"string",
            "description":"Identifies the tracking reference associated with payment.",
            "nullable":true,
            "x-queryable":true
        },
        "PaymentHeaderKey":{
            "type":"integer",
            "description":"Identifies the primary key value of the payment.",
            "format":"int64",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "VoidDatetime":{
            "title":"Void Date Time",
            "type":"string",
            "description":"Identifies the void date time.",
            "format":"date-time",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Back to Top