POST /domestic-standing-orders

  • Live
  • 3.1.4

Usage

POST /domestic-standing-orders

Description

You can use this endpoint to submit your Domestic Standing Order for processing. This can only be done once your payment has been authorised by our Member, which can be done using the POST /domestic-standing-order-consents API. Don't forget, you must submit your payment for scheduling 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 standing orders
'Frequency' values that are supported are IntvrlWkDay and IntvrlMnthDay
'FirstPaymentDateTime' cannot be more than a year in the future
'RecurringPaymentDateTime' must be after the first payment date
'FinalPaymentDateTime' cannot be more than 50 years in the future
For 'SchemeName' we accept 'UK.OBIE.SortCodeAccountNumber' with an 'Identification' of a SCAN (6 digit Sort Code and 8 digit Account Number with no spaces)

Response

Response Data Block Optional Data Fields NBS Implementation
/Data/Charges Charges Not Returned
/Data/Initiation Reference Returned
NumberOfPayments Returned
RecurringPaymentDateTime Returned
FinalPaymentDateTime Returned
/Data/Initiation/RecurringPaymentAmount <RecurringPaymentAmount> Block Returned
/Data/Initiation/FinalPaymentAmount <FinalPaymentAmount> Block Returned
/Data/Initiation/DebtorAccount <DebtorAccount> Block Returned
Name Returned
SecondaryIdentification Returned
/Data/Initiation/CreditorAccount SecondaryIdentification Returned
Data/Initiation/DebtorAccount <DebtorAccount> Block Returned
Name Returned
SecondaryIdentification Returned
/Data/Initiation/CreditorAccount <CreditorAccount> Block Returned
SecondaryIdentification Returned
/Data/MultiAuthorisation <MultiAuthorisation> Block Not Returned

API Reference

/domestic-standing-orders
post /domestic-standing-orders
Create Domestic Standing Orders

Resource URL

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

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

OBWriteDomesticStandingOrder3Param
(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 Standing Orders

Response Error Details
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not found
  • 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