Retrieve personalized payment methods for a specific customer

curl --request POST \
  --url https://mock-merchant-api-portal-dev.d.eks.aws.cld.resurs.com/v2/stores/{store_id}/payment_methods/personalized \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "governmentId": "197906023457",
  "customerSessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 123
}
'

{
  "content": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "type": "RESURS_CARD",
      "minPurchaseLimit": 123,
      "maxPurchaseLimit": 123,
      "minApplicationLimit": 123,
      "maxApplicationLimit": 123,
      "legalLinks": [
        {
          "url": "https://priceinfo.resurs.com/prisskyltning.html?countryCode=SE&amp;authorizedBankproductId=NZ690101&amp;representativeId=107&amp;creditAmount=2500",
          "type": "PRICE_INFO",
          "appendAmount": false
        }
      ],
      "disabled": false,
      "applicationRequired": true,
      "account": {
        "availableAmount": 123,
        "creditLimit": 123
      },
      "priceSignagePossible": true
    }
  ],
  "page": {
    "number": 1,
    "size": 10,
    "totalElements": 100,
    "totalPages": 10
  }
}

Advanced usage - Payment methods

Retrieve personalized payment methods for a specific customer

Availability

This endpoint is only available to partners who have been granted the “customer-identified” authority, which means that the partner is responsible for identifying their customers.

Functionality

Retrieves a list of payment methods that are personalized for a specific customer based on their governmentId and purchase amount. The payment methods returned may be restricted or require credit application based on the customer’s existing account balance and limits. This method is only applicable to government id that is of a natural type.

Customer identification

The customer is identified either by a government id or a customer session id that is used to fetch the government id from the customer session service. Only one of these values should be included in the request.

Response values

disabled

The disabled field indicates whether this payment method is currently disabled for the customer. For example, if the customer has an account but does not have enough limit to make the purchase and a limit increase is not possible, or if the customer has an account but is not allowed to use the account.

applicationRequired

The applicationRequired field indicates if a credit application is necessary for the customer to continue utilizing this payment method. For instance, if the customer does not have an associated account, or if the customer requires an increase in their credit limit when they already have an active account.

account

The account field indicates whether the customer has an active and available account for the payment method. This value will only be present for payment methods that can have an associated account, such as RESURS_REVOLVING_CREDIT, RESURS_CARD and RESURS_PART_PAYMENT.

RESURS_REVOLVING_CREDIT and RESURS_CARD are revolving accounts that can be reused for multiple purchases.
RESURS_PART_PAYMENT is a one-time account that can only be used for a single purchase. Once a purchase has been made on the RESURS_PART_PAYMENT account, the hasAccount field will not be present.

account.availableAmount

The account.availableAmount field indicates the amount of credit that is available for the customer to use for their purchase. This value will only be present for payment methods that have a credit limit associated with the customer’s account, such as RESURS_REVOLVING_CREDIT, RESURS_CARD and RESURS_PART_PAYMENT.

account.creditLimit

The account.creditLimit field indicates the maximum amount of credit that is available to the customer for the associated payment method. This value will only be present for payment methods that have a credit limit associated with the customer’s account, such as RESURS_REVOLVING_CREDIT, RESURS_CARD and RESURS_PART_PAYMENT.

Authorization

@accessController.hasAccessToPersonalized(#storeId, #request)

POST

stores

{store_id}

payment_methods

personalized

Retrieve personalized payment methods for a specific customer

curl --request POST \
  --url https://mock-merchant-api-portal-dev.d.eks.aws.cld.resurs.com/v2/stores/{store_id}/payment_methods/personalized \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "governmentId": "197906023457",
  "customerSessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 123
}
'

{
  "content": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "type": "RESURS_CARD",
      "minPurchaseLimit": 123,
      "maxPurchaseLimit": 123,
      "minApplicationLimit": 123,
      "maxApplicationLimit": 123,
      "legalLinks": [
        {
          "url": "https://priceinfo.resurs.com/prisskyltning.html?countryCode=SE&amp;authorizedBankproductId=NZ690101&amp;representativeId=107&amp;creditAmount=2500",
          "type": "PRICE_INFO",
          "appendAmount": false
        }
      ],
      "disabled": false,
      "applicationRequired": true,
      "account": {
        "availableAmount": 123,
        "creditLimit": 123
      },
      "priceSignagePossible": true
    }
  ],
  "page": {
    "number": 1,
    "size": 10,
    "totalElements": 100,
    "totalPages": 10
  }
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

store_id

string

required

The UUID of the store Unique identifier of the store

Example:

"123e4567-e89b-12d3-a456-426655440000"

Body

application/json

governmentId

string

Government-issued identification number of the customer, such as a national ID number or social security number. This should always be included when there is no customer session.

Example:

"197906023457"

customerSessionId

string<uuid>

A unique session id that is used to verify that the customer is identified and has access to the requested data. If this is included, governmentId should be omitted.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

amount

number

The total cost of the purchase. If the customer already has an account associated with this payment method, and the amount is provided, it will be used to update the 'disabled' and 'applicationRequired' flags based on the account's available balance and limits.

Response

Paginated list of payment methods

content

object[]

List of page entries

Show child attributes

page

object

Page information

Show child attributes

Retrieve a paged list of stores accessible by the current user Retrieve the application data specification for a payment method

Merchant API v2

Stores endpoints

OAuth2 endpoints

Retrieve personalized payment methods for a specific customer

Availability

Functionality

Customer identification

Response values

disabled

applicationRequired

account

account.availableAmount

account.creditLimit

Authorization

Authorizations

Path Parameters

Body

Response