Payment details

GET

/payment/v1/payments/{uuid}

Returns the final detail of a PSD2 payment once completed. Includes bank status, settled amounts, source/destination accounts and bank references.

The paymentUuid is the one returned in payment.paymentUuid by GET /flow/v1/operations/{operationUuid}, and is available once the operation reaches the COMPLETED state. The response includes the instructed amount, remittance information, execution date, bank payment identifier and both creditor (beneficiary) and debtor (payer) accounts.

The response exposes the channel attribution (collaborator) inherited from the flow that originated the payment.

Autorizaciones

OAuth2

OAuth2 security scheme

clientCredentials Flow

URL del token"/api/v2/auth/token"

Scopes:

• "zertiban-api"Access to the API

Parámetros

Header Parameters

x-tenant-id*

Organisation UUID (tenant identifier)

Tipo

string

Requerido

Formato

"uuid"

Path Parameters

uuid*

PSD2 payment UUID. Obtained from payment.paymentUuid in the flow operation detail once the operation is COMPLETED.

Tipo

string

Requerido

Formato

"uuid"

Respuestas

Payment successfully retrieved

Content-Type

application/json

{

  

"uuid": "2beaa311-67fe-4c72-8cc4-35c02664d6c7",

  

"type": "PSD2_PAYMENT",

  

"psd2Payment": {

  

  

"type": "SINGLE_PAYMENT",

  

  

"product": "SEPA_CREDIT_TRANSFER",

  

  

"uuid": "string",

  

  

"status": {

  

  

  

"status": "SUBMITTED_VALID",

  

  

  

"code": "CREATED"

  

  

},

  

  

"instructedAmount": {

  

  

  

"amount": 176483,

  

  

  

"currency": "EUR"

  

  

},

  

  

"remittanceInformationUnstructured": "My concept 123",

  

  

"executionDate": "2025-10-20T14:54:23Z",

  

  

"requestedExecutionDate": "2025-10-20",

  

  

"bankPaymentId": "bank-id-72762678",

  

  

"creditorAccount": {

  

  

  

"ownerName": "ACME Corp",

  

  

  

"accountNumber": "ES3401001234123412343999",

  

  

  

"bic": "CAIXESBBXXX",

  

  

  

"country": "España",

  

  

  

"type": "string"

  

  

},

  

  

"debtorAccount": {

  

  

  

"accountNumber": "ES3401001234123412343999",

  

  

  

"type": "IBAN",

  

  

  

"currency": "EUR",

  

  

  

"psuName": "John",

  

  

  

"ownerName": "John",

  

  

  

"bic": "CAIXESBB",

  

  

  

"participants": [

  

  

  

  

{

  

  

  

  

  

"role": "LEGAL_REPRESENTATIVE",

  

  

  

  

  

"name": "Clare"

  

  

  

  

}

  

  

  

]

  

  

}

  

},

  

"collaborator": {

  

  

"uuid": "f7c1a2b3-4d5e-6f70-8192-a3b4c5d6e7f8"

  

}

}

GET

/payment/v1/payments/{uuid}

Playground

Servidor

Autorización

OAuth2

Headers

x-tenant-id*

Variables

Key

Value

uuid*

Ejemplos