Create Payment Session

{
  "header": {
    "merchantId": "Aera Merchant ID",
    "idempotency-key": "UUID v7 provided by merchant to uniquely identify the request"
  },
  "body": {
    "merchantData": {
      "ui": {  
        "mode": "enum EMBED, optional only if you want to embed Aera´s hosted checkout form in your checkout",
        "origin": "merchant URL"
      },
      "successRedirectUrl": "Redirect URL on successful payment",
      "cancelRedirectUrl": "Redirect URL on payment cancel",
      "errorRedirectUrl": "Redirect URL on payment error",
      "callbackUrl": "Absolute or relative URL (validated against configured domain)"
    },
    "transactionData": {
      "merchantReference": "Merchant provided reference to the payment (e.g. order number)",
      "immediateCapture": "Optional, true if immediate capture requested, default false",
      "forceAuthentication": "Optional, true if explicit authentication is requested",
      "splitShipment": "Optional, true if shipment potentially can be split into multiple shipments",
			"storePaymentInstrument": "Optional, true if storing the payment instrument is mandated",
      "amountDetails": {
        "amount": "Gross amount in minor units",
        "currency": "ISO 4217 alphabetic code (e.g.NOK), must be the same as the merchant currency"
      },
      "orderData": {
        "orderItems": [
          {
            "itemId": "invoice: Applicable for invoice based payment methods like Walley B2C and B2B invoice payments. itemId: The Product ID of the item",
            "description": "Product description",
            "quantity": 1,
            "quantityUnit": "Optional: Default pc",
            "itemPrice": "Unit price incl. VAT",
            "taxPercentage": "VAT percentage",
            "itemPriceExclTax": "Optional: Unit price excl. VAT",
            "taxAmount": "Optional: Tax amount",
            "itemUrl": "Optional: Product URL",
            "imageUrl": "Optional: Product image URL"
          }
        ]
      }
    },
    "paymentInstrumentsProfileData": {
      "merchantShopperId": "Conditional: Merchant provided end-user ID (e.g. loyalty number, phone number)",
      "pspShopperId": "Conditional: UUID assigned by PSP, either merchantShopperId or pspShopperId required",
      "paymentInstrumentReference": "Optional: Reference to a pre selected payment instrument",
      "allowStoredInstrumentsOnly": "Optional: Only present stored payment instruments as payment option - Default false"
    },
    "shopperData": {
      "name": "Name of the shopper",
      "email": "Email of the shopper",
      "phoneNumber": "Phone number of the merchant",
      "shippingAddress": {
      "street": "Street name",
      "houseNumberOrName": "House number (or name) in the street",
      "city": "Name of the city",
      "postalCode": "Postal/ZIP code",
      "country": "Country of the shipping address"
      }
     },
    "paymentMethodData": {
      "paymentMethodWhitelist": [
        "Optional: List of payment methods allowed for this transaction"
      ],
      "paymentMethodDetails": [
        {
          "CARD": {
            "cardSchemeWhitelist": [
              "Optional: List of allowed card schemes in case you want to limit the list"
            ]
          }
        },
        {
          "MERCHANTWALLET": [ 
            {
              "walletId": "MERCHANTWALLET object: Applicable to merchant specific wallet based on Aera´s white label wallet. walletId: Unique ID provided by Wallet Service Provider",
              "dpaId": "Optional: If omitted, all DPAs for given wspId are available",
              "claimedUserIds": [
                {
                  "cuid": "Claimed User ID",
                  "cuidType": "LOYALTY | SDKID | DYNAMIC_SDKID | MOBILE"
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

{
  "responseInfo": {
    "responseCode": "000",
    "responseText": "Approved"
  },
  "sessionInfo": {
    "pspReference": "018f7a2e-8f5c-7a9b-b123-123456789abc",
    "createdAt": "2026-03-01T10:15:30Z",
    "expiredAt": "2026-03-01T10:30:30Z",
    "checkoutUrl": "https://checkout.aera.com/session/abc123"
  }
}