SCT - Payment recall operation

Prev Next
Post
/v5/credit-transfer/payment/{paymentId}/recall

Execute a recall operation. It will send a camt.056 message to recall a previous pacs.008 payment.

Security
HTTP
Type bearer
Path parameters
paymentId
stringRequired

Unique identification as assigned by the Payments Hub to uniquely identify the payment submission resource.

Body parameters
object
originator
string
Valid values[ "BANK", "CUST" ]
reason
string Required
Valid values[ "AC03", "AM09", "DUPL", "CUST", "FRAD", "TECH" ]
recallRefId
string Required
Responses
200

OK

object
recallId
string
Example7e3e1fe8-f57d-348c-aa72-c6e119c7e7dd
400
{
  "errors": [
    {
      "code": "400",
      "message": "Bad Request",
      "level": "error",
      "description": "Error details"
    }
  ]
}
401
{
  "errors": [
    {
      "code": "401",
      "message": "Unauthorized",
      "level": "error",
      "description": "Error details"
    }
  ]
}
403
{
  "errors": [
    {
      "code": "403",
      "message": "Forbidden",
      "level": "error",
      "description": "Error details"
    }
  ]
}
404

Not Found

{
  "errors": [
    {
      "code": "404",
      "message": "Not found",
      "level": "error",
      "description": "Payment message ID not found"
    }
  ]
}
405

Method Not Allowed

object
500
{
  "errors": [
    {
      "code": "500",
      "message": "Internal Server Error",
      "level": "error",
      "description": "Error details"
    }
  ]
}
503

Service Unavailable

{
  "errors": [
    {
      "code": "503",
      "message": "Service unavailable",
      "level": "error",
      "description": "Service unavailable"
    }
  ]
}