Create Payment
const url = 'https://example.com/v1/payment';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"idempotencyKey":"order-20051","merchantTransaction":{"monetaryValue":{"amount":39.99,"currencyCode":"EUR"},"merchantOpportunityId":"online-shop","merchantTransactionId":"order-20051","merchantReference":"Order 20051","country":"DE"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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" } }'Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”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
Required for integrators; optional for direct merchants, where it must match the certificate owner.
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.
object
object
Opportunity identifier within the actual seller.
Optional handover for approved direct merchants only; integrator requests must omit it.
object
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" }}Integrator using its own certificate for seller-a
{ "sellerEntityId": "seller-a", "idempotencyKey": "integrator-order-20051", "merchantTransaction": { "monetaryValue": { "amount": 39.99, "currencyCode": "EUR" }, "merchantOpportunityId": "online-shop", "merchantTransactionId": "order-20051", "merchantReference": "Order 20051", "country": "DE" }}Responses
Section titled “Responses”Payment created; redirect the payer to redirectUrl
object
Opaque payment identifier. Store and use the value exactly as returned.
Example
{ "transactionId": "267K3M9W2R5X8N4T6P"}Invalid request body or unsupported overrides (18012), invalid checkout (18016), missing sellerEntityId for an integrator (18020), or missing merchantTransaction (18030).
object
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.
object
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.
object
Examples
{ "code": "18025", "message": "Seller is not assigned to the authenticated integrator"}{ "code": "18028", "message": "Integrator payments are not enabled"}Unknown seller (18021) or opportunity unavailable to that seller (18026).
object
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.
object
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.
object
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.
object
Example generated
{ "code": "example", "message": "example"}default
Section titled “default”Error
object
Example generated
{ "code": "example", "message": "example"}
