Skip to main content
POST
/
v2
/
banking
/
payments
Create Payment
curl --request POST \
  --url https://api.business-os.de/v2/banking/payments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "provider_code": "musterbank_oauth_client_de",
  "template_identifier": "SEPA",
  "payment_attributes": {
    "amount": "1.00",
    "currency_code": "EUR",
    "description": "Rechnung G-RE-2026-03024",
    "creditor_iban": "DE27100777770209299700",
    "creditor_name": "Mustermann GmbH",
    "debtor_iban": "DE89370400440532013000",
    "end_to_end_id": "G-RE-2026-03024"
  },
  "return_to": "https://app.business-os.de/close",
  "custom_fields": {
    "invoice_id": "G-RE-2026-03024"
  }
}
'
{
  "data": {
    "expires_at": "2026-03-24T12:44:03Z",
    "payment_url": "https://www.saltedge.com/payments/connect?token=xxx",
    "payment_id": "4509182736450918273"
  }
}

Authorizations

​
x-api-key
string
header
required

Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.

Query Parameters

​
api
enum<string>
default:partner

Salt Edge API: partner (regulierte Banken) oder openbanking (unregulierte wie AMEX, Revolut)

Available options:
partner,
openbanking

Body

application/json

Request-Body zum Initiieren einer Zahlung

​
provider_code
string
required

Technischer Provider-Code der Bank

Example:

"musterbank_oauth_client_de"

​
template_identifier
enum<string>
required

Zahlungsart (SEPA oder SEPA Instant)

Available options:
SEPA,
SEPA_INSTANT
Example:

"SEPA"

​
payment_attributes
object
required

Zahlungsdetails

​
return_to
string<uri>

Redirect-URL nach Zahlungsbestätigung

Example:

"https://app.business-os.de/close"

​
custom_fields
object

Benutzerdefinierte Felder (werden im Callback zurückgegeben)

Example:
{ "invoice_id": "G-RE-2026-03024" }

Response

Zahlung initiiert — User muss die payment_url aufrufen

Antwort beim Initiieren einer Zahlung

​
data
object