Request to verify payment status (pacs.028)

This tutorial describes how you can request the status of a previously sent SEPA Instant Credit Transfer (SCT Inst) using the PagoNxt Payments Hub pacs.028 message and accompanies the header information found in the Verify status of a payments message tutorial

For this tutorial, consider a scenario where a financial institution has submitted a SEPA Instant payment on behalf of a customer, but has not yet received a confirmation of its successful processing. To resolve the uncertainty, the institution sends a pacs.028 message to inquire about the current status of the payment.

Sandbox
The instructions in this tutorial apply to the sandbox environment

Payment Status Request

Request body

The request must include a JSON payload object in the request body. The JSON payload is a pacs.028 ISO message with the fitoFIPmtStsReqroot element, and it contains the request details for verifying a payment status.

The following table only provides information about some especially important fields. For details on all the required and optional message fields, see Message field definition for pacs.028 .

Message field	Description	Data type	Required/Optional
grpHdr.instgAgt	Data structure containing instructing agent information. This field is Mandatory (M) when sending to the Clearing House. It is not reported in an incoming flow.	Object	Optional
grpHdr.msgId	Message ID defined by the submitter to uniquely identify the payment internally.	String	Required
grpHdr.creDtTm	Message creation date and time	ISODateTime	Required
orgnlGrpInf.orgnlMsgNmId	Message ID of the original message, either: * a pacs.008 .001.02 or pacs.008.001.08 for an SCT Inst investigation * a camt.056.001.01 or camt.056.001.08 for an investigation on a Recall	String	Required
orgnlGrpInf.orgnlMsgId	Name of the message format used in the original request.	String	Required
txInf.orgnlTxId	Original transaction ID of the transaction being investigated.	String	Required
txInf.orgnlTxRef	Data structure containing the transaction reference used to identify the original transaction	Object	Required

Example request body:

{
  "orgnlGrpInf": [
    {
      "orgnlMsgNmId": "pacs.008.001.08",
      "orgnlMsgId": "1981259ee94c3cc9854350a1b914e758"
    }
  ],
  "txInf": [
    {
      "orgnlTxId": "00490001632XQJZNFB",
      "orgnlTxRef": {
        "dbtrAcct": {
          "id": {
            "iban": "ES5500490001532111373722"
          }
        },
        "cdtr": {
          "pty": {
            "nm": "DOC07815006C DOC07815006C ES"
          }
        },
        "dbtr": {
          "pty": {
            "nm": "Q.G. ARREDAMENTI S.A.S."
          }
        },
        "dbtrAgt": {
          "finInstnId": {
            "bicfi": "BSCHESMMXXX"
          }
        },
        "rmtInf": {
          "ustrd": [
            "Prueba investigación CIB"
          ]
        },
        "cdtrAcct": {
          "id": {
            "iban": "DE25503205000450340253"
          }
        },
        "cdtrAgt": {
          "finInstnId": {
            "bicfi": "BSCHDEFFXXX"
          }
        },
        "sttlmInf": {
          "clrSys": {
            "prtry": "TIP"
          },
          "sttlmMtd": "CLRG"
        },
        "pmtTpInf": {
          "svcLvl": [
            {
              "cd": "SEPA"
            }
          ],
          "lclInstrm": {
            "cd": "INST"
          }
        },
        "intrBkSttlmAmt": {
          "ccy": "EUR",
          "value": 2.42
        },
        "intrBkSttlmDt": "2024-09-13"
      },
      "stsReqId": "stsReqId1752150421",
      "orgnlEndToEndId": "NOT PROVIDED"
    }
  ],
  "grpHdr": {
    "instgAgt": {
      "finInstnId": {
        "bicfi": "BSCHDEFFXXX"
      }
    },
    "msgId": "msgId1752150421",
    "creDtTm": "2024-09-16T10:01:18.595Z"
  }
}