Settlement Service (DESP-hosted) — Backend Specification

OpenAPI 3.0.3. Hosted by desp. The DESP-side counterpart to spec-settlementpsp — together these two specs define the full settlement request/response contract between a pilot-psp and DESP. See funding-and-defunding and online-and-offline-payments for the business-process context these endpoints implement.

Endpoints

Method	Path	operationId	Purpose
POST	`/v1/fundings`	`fundingsRequest`	Fund a digital euro account (held by the requesting PSP) from a commercial money account
POST	`/v1/defundings`	`defundingsRequest`	Defund from a Digital Euro account to a commercial money account
POST	`/v1/payment-instructions`	`paymentinstructions`	Receive a payment instruction hosted by DESP
POST	`/v1/payments`	`payments`	Receive a payment request hosted by DESP
POST	`/v1/refunds`	`refunds`	Receive a refund request hosted by DESP
GET/callback	`/v1/payments/{payment-id}/status`	`paymentsStatusUpdate`	Payment status hosted by DESP
GET	`/v1/payments/{payment-id}/status-inquiries`	`paymentsStatusInquiry`	Query payment status
GET	`/v1/payment-instructions/{payment-instruction-id}/status`	`paymentInstructionStatus`	Status for a payment instruction, payment request or refund
GET	`/v1/refunds/{refund-id}/status`	`refundStatus`	Status for a payment instruction, payment request or refund
GET	`/v1/fundings/{funding-id}/status`	`fundingsStatus`	Status for a funding
GET	`/v1/defundings/{defunding-id}/status`	`defundingsStatus`	Status for a defunding