Skip to content

Create Payment

POST
/v1/payment
curl --request POST \
--url https://example.com/v1/payment \
--header 'Content-Type: application/json' \
--data '{ "idempotencyKey": "order-20051", "merchantTransaction": { "monetaryValue": { "amount": 39.99, "currencyCode": "EUR" }, "merchantOpportunityId": "online-shop", "merchantTransactionId": "order-20051", "merchantReference": "Order 20051", "country": "DE" } }'
Media typeapplication/json

Direct merchants and integrators use the same business fields. The certificate identifies the account submitting the request and paying Net Money’s fees. The actual seller owns the opportunity and receives the bank payment. Confirm with your Integration Manager that your account can submit payments for the selected merchant. Return URLs, caller identity, fee debtor and integration mode cannot be supplied as overrides. Retry with the same caller, seller, idempotency key and business data to recover the original payment.

object
sellerEntityId

Required for integrators; optional for direct merchants, where it must match the certificate owner.

string
idempotencyKey
required

Scoped to the authenticated caller and actual seller. Changed business data under the same key returns HTTP 409, code 13002; a new key identifies a separate submission.

string
merchantTransaction
required
object
monetaryValue
required
object
amount
number
currencyCode
string
merchantOpportunityId
required

Opportunity identifier within the actual seller.

string
merchantTransactionId
required
string
merchantReference
required
string
country
required
string
checkout

Optional handover for approved direct merchants only; integrator requests must omit it.

object
description
string
stripeCheckoutSessionId
string

Examples

Direct merchant using its own certificate

{
"idempotencyKey": "order-20051",
"merchantTransaction": {
"monetaryValue": {
"amount": 39.99,
"currencyCode": "EUR"
},
"merchantOpportunityId": "online-shop",
"merchantTransactionId": "order-20051",
"merchantReference": "Order 20051",
"country": "DE"
}
}

Payment created; redirect the payer to redirectUrl

Media typeapplication/json
object
transactionId

Opaque payment identifier. Store and use the value exactly as returned.

string
redirectUrl
string

Example

{
"transactionId": "267K3M9W2R5X8N4T6P"
}

Invalid request body or unsupported overrides (18012), invalid checkout (18016), missing sellerEntityId for an integrator (18020), or missing merchantTransaction (18030).

Media typeapplication/json
object
code
string
message
string

Example

{
"code": "18020",
"message": "sellerEntityId is required for integrator requests"
}

Certificate identity is not active and current (18002). TLS handshake failures occur before an HTTP response.

Media typeapplication/json
object
code
string
message
string

Example generated

{
"code": "example",
"message": "example"
}

Direct seller mismatch (18022), invalid caller/seller type (18023/18024), denied integrator affiliation (18025), or integrator submissions disabled (18028). Use the account and merchant assignment agreed with your Integration Manager.

Media typeapplication/json
object
code
string
message
string

Examples

{
"code": "18025",
"message": "Seller is not assigned to the authenticated integrator"
}

Unknown seller (18021) or opportunity unavailable to that seller (18026).

Media typeapplication/json
object
code
string
message
string

Example generated

{
"code": "example",
"message": "example"
}

The authenticated caller reused an idempotency key for the same seller with different business data (13002). Identical authorized retries return the original transaction ID and preserve the receiving account and return URLs.

Media typeapplication/json
object
code
string
message
string

Example

{
"code": "13002",
"message": "Idempotency key reused with different parameters"
}

New acceptance lacks opportunity return URLs (18019) or valid configured HTTPS destinations (18027), or required billing/account configuration is incomplete (16002). Authorized retries preserve the accepted destinations.

Media typeapplication/json
object
code
string
message
string

Example

{
"code": "18019",
"message": "Missing redirect URL configuration for the selected merchant opportunity: success_redirect_url, failure_redirect_url"
}

Net Money could not process the payment (18029), or another server error occurred. Contact your Integration Manager and retain the original request and key when the outcome is uncertain.

Media typeapplication/json
object
code
string
message
string

Example generated

{
"code": "example",
"message": "example"
}

Error

Media typeapplication/json
object
code
string
message
string

Example generated

{
"code": "example",
"message": "example"
}