POST /domestic-payments

  • Live
  • 3.1.4

Usage

POST /domestic-payments

Description

You can use this endpoint to submit your Domestic Immediate Payment for processing. This can only be done once your payment has been authorised by our Member, which can be done using the POST /domestic-payment-consents API. Don't forget, you must submit your payment for execution within 1 hour of it being authorised.

Below, you can find our implementation and returned optional fields for version 3.1.1 of this API.

 

Request

Request
As per OBIE specification
Nationwide joint accounts are 'one-to-sign' therefore we do not require / support 'multi-authorisation' for domestic-payments

Response

Response Data Block Optional Data Fields NBS Implementation
/Data <Data> Block Returned
ExpectedExecutionDateTime Not Returned
ExpectedSettlementDateTime Not Returned
/Data/Charges Charges Not Returned
/Data/Initiation LocalInstrument Returned
/Data/Initiation/DebtorAccount <DebtorAccount> Block Returned
Name Returned
SecondaryIdentification Returned
/Data/Initiation/CreditorAccount <CreditorAccount> Block Returned
SecondaryIdentification Returned
/Data/Initiation/CreditorPostalAddress <CreditorPostalAddress> Block Returned
AddressType Returned
Department Returned
SubDepartment Returned
StreetName Returned
BuildingNumber Returned
PostCode Returned
TownName Returned
CountrySubDivision Returned
Country Returned
AddressLine Returned
/Data/Initiation/RemitanceInformation <RemittanceInformation> Block Returned
Unstructured Returned
Reference Returned
/Data/MultiAuthorisation <MultiAuthorisation> Block Not Returned

API Reference

/domestic-payments
post /domestic-payments
Create Domestic Payments

Resource URL

https://api-internal.obtpp.nationwideinterfaces.io/open-banking/v3.1/pisp /domestic-payments

Header Parameters

Content-Type

x-fapi-auth-date

The time when the PSU last logged in with the TPP. All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: Sun, 10 Sep 2017 19:43:31 UTC

x-fapi-customer-ip-address

The PSU's IP address if the PSU is currently logged in with the TPP.

x-fapi-interaction-id

An RFC4122 UID used as a correlation id.

Authorization
(required)

An Authorisation Token as per https://tools.ietf.org/html/rfc6750

x-idempotency-key
(required)

Every request will be processed only once per x-idempotency-key. The Idempotency Key will be valid for 24 hours.

x-jws-signature
(required)

A detached JWS signature of the body of the payload.

x-customer-user-agent

Indicates the user-agent that the PSU is using.

Body Parameters

OBWriteDomestic2Param
(required)

Request Body

Default

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Resource Summary

Security

Category

Domestic Payments

Response Error Details
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden
  • 405 Method Not Allowed
  • 406 Not Acceptable
  • 415 Unsupported Media Type
  • 429 Too Many Requests
  • 500 Internal Server Error

Working...

API Personas

Sam Jones
  • Retail
  • Lives alone
  • Is overdrawn
View Persona
Patrick Nadwarna
  • Retail
  • No regular payments
  • Large balance
View Persona
Cathy Powell
  • Retail
  • Fraud victim
  • Restricted account
View Persona
Josh Chambers
  • Retail
  • Economics student
  • Uses different payment channels
View Persona
Maz Patel
  • Retail
  • Full-time mum
  • Frequent spender
View Persona
Darren Nowak
  • Retail
  • Rarely at home
  • Financially savvy
View Persona
Janet Simpson
  • Retail
  • Closing current account
  • Insufficient funds
View Persona
Melanie Rossi
  • Retail
  • Travels a lot
  • Locked current account
View Persona
Hattie Walker
  • Retail
  • Credit card account
  • Frequent credit card use
View Persona
Victor Braganza
  • Retail
  • Credit card account
  • Inactive account
View Persona
Alex Baker
  • Retail
  • Credit card account
  • Restricted account
View Persona
Martin Hanger
  • Retail
  • Buying new house
  • Evaluating affordability
View Persona
Keesha Mclintock
  • Retail
  • Credit card account
  • Applying for a mortgage
View Persona
Jason Costello
  • Business
  • J C Plumbing
  • New business
View Persona
Jozef Ivan
  • Business
  • The Cake Cave
  • New business
View Persona
Brian McKay
  • Business
  • Johnson's Fish & Chip
  • Money Laundering- Fraud
View Persona
Lee Waterman
  • Business
  • L W Car Parts
  • Lots of payments
View Persona
Muhammed Patel
  • Business
  • Snips
  • Shrinking business
View Persona
Sharon Snow
  • Business
  • Endeavour Web Designs
  • Established, highly successful
View Persona
Lucy Baines
  • Business
  • The Royal Oak
  • Moving business account
View Persona
Roland Hanbury
  • Business
  • Grey Fox Marketing
  • Working abroad
View Persona