v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Authorizations

Cancel authorization

Perform a full cancellation of an authorization. The authorization must have the status PENDING or PROCESSED and must also not have been previously confirmed (cleared). This endpoint generates a Network authorization received event.

post/direct-network-transactions/v1/cancellation

Request body

network_authorization_idinteger required

Authorization ID—this field is mandatory if the authorization_code field is not provided.

authorization_codestring required

Authorization code—this field is mandatory if the network_authorization_id field is not provided.

transaction_identifierstring

Transaction ID

retrieval_reference_numberstring

Number generated by merchant point of sale (POS) system.

card_idinteger required

Transaction card ID

originstring

This field identifies the origin of the operation to be cancelled as MIGRATION, ONUS, or STRIKER.

Example request

{
  "network_authorization_id": 1231232,
  "authorization_code": "000SHK",
  "transaction_identifier": "ZZIR8T",
  "retrieval_reference_number": "000000000000355",
  "card_id": 124123,
  "origin": "ONUS"
}

Response

Full cancellation accepted

messagestring required

Success message

Example response

{
  "message": "Success"
}