Update a payment and continue processing

patch https://cert.api.firstdata.com/gateway/v2/payments/{transaction-id}

Use this to handle a redirect response, updating the transaction and continuing processing.

Path Params

transaction-id

string

required

Gateway transaction identifier as returned in the parameter ipgTransactionId or merchantTransactionId.

Body Params

Secure3DAuthenticationUpdateRequest

Secure3D21AuthenticationUpdateRequest

Headers

Content-Type

string

enum

required

Defaults to application/json

Content type.

Allowed:

Client-Request-Id

string

required

A client-generated ID for request tracking and signature creation, unique per request. This is also used for idempotency control. We recommend 128-bit UUID format.

Api-Key

string

required

Key given to merchant after boarding associating their requests with the appropriate app in Apigee.

Timestamp

int64

required

Epoch timestamp in milliseconds in the request from a client system. Used for Message Signature generation and time limit (5 mins).

Message-Signature

string

required

Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal.

Responses

Language

Credentials

Header

URL


xxxxxxxxxx
1
curl --request PATCH \
2
     --url https://cert.api.firstdata.com/gateway/v2/payments/transaction-id \
3
     --header 'Content-Type: application/json' \
4
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success response.

400The request cannot be validated.

401The request cannot be authenticated or was submitted with the wrong credentials.

403The request was unauthorized.

404The requested resource doesn't exist.

409The attempted action is not valid according to gateway rules. For example, the merchant is not set-up or the order already exists.

415Format that is not supported by the server for the HTTP method.

422The processor declined the transaction.

500An unexpected internal server error occurred.

502There was a problem communicating with the endpoint.