---
title: "Transaction:Create"
method: POST
path: "/transactions"
tags: ["Transactions"]
---

# Transaction:Create

`POST /transactions`

## Request

- Base URL: `https://rest.pay.nl/v2`
- URL: `https://rest.pay.nl/v2/transactions`
- Auth: HTTP basic

This endpoint is used to create a transaction in redirect mode. By calling this endpoint, you get a transactionID and a paymentUrl which can be used to redirect the payer. After the payment, the payer will be redirected to the provided returnUrl, where you can check the status and process the order.

You need to authenticate with an AT code (as username) and the corresponding token (as password) or you can authenticate with a SL code (as username) and the corresponding secret (as password)

## Request body

- object
  - `serviceId` string: The ID of your service. Required if you authenticate with AT-code/token. You can find the service ID in the portal.
  - `description` Description (unresolved $ref)
  - `reference` Reference (unresolved $ref)
  - `expire` Expire (unresolved $ref)
  - `returnUrl` ReturnUrl, required (unresolved $ref)
  - `exchangeUrl` ExchangeUrl (unresolved $ref)
  - `amount` Amount, required
    - `value` integer, required: The amount in cents.
    - `currency` string: The currency in ISO-4217 format.
  - `paymentMethod` object
    - `id` Id (unresolved $ref)
    - `subId` SubId (unresolved $ref)
  - `integration` Integration
    - `testMode` boolean: Indicates if the service is in testmode or not, possible values: false or true
  - `customer` object
    - `firstName` FirstName (unresolved $ref)
    - `lastName` LastName (unresolved $ref)
    - `ipAddress` Ip (unresolved $ref)
    - `birthDate` BirthDate (unresolved $ref)
    - `gender` Gender (unresolved $ref)
    - `phone` Phone (unresolved $ref)
    - `email` Email (unresolved $ref)
    - `language` Language (unresolved $ref)
    - `trust` Trust (unresolved $ref)
    - `reference` Reference (unresolved $ref)
    - `company` Company (unresolved $ref)
  - `order` object
    - `countryCode` CountryCode (unresolved $ref)
    - `deliveryDate` DeliveryDate (unresolved $ref)
    - `invoiceDate` InvoiceDate (unresolved $ref)
    - `deliveryAddress` object
      - `firstName` FirstName (unresolved $ref)
      - `lastName` LastName (unresolved $ref)
      - `streetName` StreetName, required (unresolved $ref)
      - `streetNumber` StreetNumber, required (unresolved $ref)
      - `streetNumberExtension` StreetNumberExtension (unresolved $ref)
      - `zipCode` ZipCode, required (unresolved $ref)
      - `city` City, required (unresolved $ref)
      - `regionCode` RegionCode (unresolved $ref)
      - `countryCode` CountryCode (unresolved $ref)
    - `invoiceAddress` object
      - `firstName` FirstName (unresolved $ref)
      - `lastName` LastName (unresolved $ref)
      - `streetName` StreetName, required (unresolved $ref)
      - `streetNumber` StreetNumber, required (unresolved $ref)
      - `streetNumberExtension` StreetNumberExtension (unresolved $ref)
      - `zipCode` ZipCode, required (unresolved $ref)
      - `city` City, required (unresolved $ref)
      - `regionCode` RegionCode (unresolved $ref)
      - `countryCode` CountryCode (unresolved $ref)
    - `products` Products (unresolved $ref)
  - `stats` Stats
    - `info` string: The used info code which can be tracked in the stats.
    - `tool` string: The used tool code which can be tracked in the stats.
    - `object` string: The object which can be tracked in stats.
    - `extra1` string: The first free value which can be tracked in the stats.
    - `extra2` string: The second free value which can be tracked in the stats.
    - `extra3` string: The third free value which can be tracked in the stats.
    - `domainId` string: The ID of the duplicate content URL
  - `notification` Notification
    - `type` 'push' | 'email': Use "push" for push messages, or "email" to send out an email. For more information check the following page: https://paynl.readme.io/reference/accounts-1
    - `recipient` string: The recipient of the notification. For push messages, use your device id (AD-XXXX-XXXX). For email, provide a valid email address (XXXX@XXXX.XX).
  - `transferData` TransferData (unresolved $ref)

## Response `201`

Created

- object
  - `id` Id (unresolved $ref)
  - `serviceId` Id (unresolved $ref)
  - `description` Description (unresolved $ref)
  - `reference` Reference (unresolved $ref)
  - `manualTransferCode` ManualTransferCode (unresolved $ref)
  - `orderId` OrderId (unresolved $ref)
  - `paymentUrl` PaymentUrl (unresolved $ref)
  - `statusUrl` StatusUrl (unresolved $ref)
  - `amount` Amount
    - `value` integer, required: The amount in cents.
    - `currency` string: The currency in ISO-4217 format.
  - `uuid` Uuid (unresolved $ref)
  - `hash` Hash (unresolved $ref)
  - `cancelUrl` CancelUrl (unresolved $ref)
  - `orderStatusUrl` OrderStatusUrl (unresolved $ref)
  - `expire` Created (unresolved $ref)
  - `expiresAt` ExpiresAt (unresolved $ref)
  - `created` Created (unresolved $ref)
  - `createdAt` Created (unresolved $ref)
  - `createdBy` CreatedBy (unresolved $ref)
  - `modified` Modified (unresolved $ref)
  - `modifiedAt` Modified (unresolved $ref)
  - `modifiedBy` ModifiedBy (unresolved $ref)

## Other responses

- `400`: Bad request, see response body for more information
- `401`: Unauthorized. Supplied AT code/token or SL code/secret is invalid
- `403`: Forbidden. Supplied credentials have no rights
- `404`: Not found
- `405`: Used HTTP method is not allowed
- `406`: Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `415`: Unsupported media. The supplied content type in the content-type parameter in the header is not supported
- `422`: Unprocessable Entity, see response body for more information
- `429`: Rate limit reached.
- `500`: An internal error occurred

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api-s.md) - [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api-s/revisions/6cd443c3aa96?raw)