Retrieve Payments

GET {{base_url}}/banking/v2/pay/payments/

The 'Retrieve payment' endpoint can be used to retrieve a particular payment using the bank id and payment id.

Attributes

FieldTypeDescription
idstringUnique identifier for the payment
bankIdintegerUnique identifier for the bank
companyIdstringUnique identifier for the company
consentIdstringUnique identifier for the consent
creditorJSON objectCreditor information
creditor -> schemeNamestringIBAN or Account and sort code
creditor -> identificationstringCreditor's account details
creditor -> namestringCreditor name
amountintegerBalance amount
currencystringAccount currency
referencestringTransaction reference
typestringPayment type {DOMESTICSCHEDULED,DOMESTIC-STANDINGORDER, DOMESTIC-PAYMENT,INTERNATIONAL-SCHEDULED, INTERNATIONAL-STANDINGORDER, INTERNATIONAL-PAYMENT}
creationDatedatetimeDate and time of the transaction
remittanceInfostringPartner Id is sent in order to reconcile payment with AIS transaction

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
X-Api-Keystring
X-Partner-Idstring
Authorizationstring
X-Company-Idstring

RESPONSES

status: OK

{"results":[{"id":"paymentId1234","consentId":"consentId3456","bankId":6,"companyId":"companyId1234","type":"DOMESTIC","status":"PENDING","amount":"25.00","currency":"GBP","reference":"reference","creditor":{"schemeName":"UK.OBIE.SortCodeAccountNumber","identification":"11223301234567","name":"Creditor name"},"creationDate":"2020-10-27T10:02:37Z","remittanceInfo":"partnerId1234"}],"links":{}}