Invoice – PayeeInfo

PayeeInfo

The payeeinfo resource contains information about the payee (i.e. a merchant, a corporation etc) related to a specific payment.

GET Request

Request

1
2
3
4

GET /psp/invoice/payments/7e6cdfc3-1276-44e9-9992-7cf4419750e1/payeeInfo HTTP/1.1
Host: api.externalintegration.payex.com
Authorization: Bearer <AccessToken>
Content-Type: application/json

GET Response

Response

1
2

HTTP/1.1 200 OK
Content-Type: application/json

1
2
3
4
5
6
7
8
9
10
11

{
    "payment": "/psp/invoice/payments/7e6cdfc3-1276-44e9-9992-7cf4419750e1",
    "payeeInfo": {
        "id": "/psp/invoice/payments/7e6cdfc3-1276-44e9-9992-7cf4419750e1/payeeInfo",
        "payeeId": "5cabf558-5283-482f-b252-4d58e06f6f3b",
        "payeeReference": "EN1234",
        "payeeName": "TestMerchant1",
        "productCategory": "EF1234",
        "orderReference": "or-123456"
    }
}

Field	Type	Description
`payment`	`string`	The relative URL and unique identifier of the `payment` resource this `payeeInfo` belongs to. Please read about URL Usage to understand how this and other URLs should be used in your solution.
`id`	`string`	The relative URL and unique identifier of the `payeeInfo` resource this `payeeInfo` belongs to. Please read about URL Usage to understand how this and other URLs should be used in your solution.
`payeeId`	`string`	This is the unique id that identifies this payee (like merchant) set by Swedbank Pay
`payeeReference`	`string`	A unique reference from the merchant system. Set per operation to ensure an exactly-once delivery of a transactional operation. Length and content validation depends on whether the `transaction.number` or the `payeeReference` is sent to the acquirer. If Swedbank Pay handles the settlement, the `transaction.number` is sent and the `payeeReference` must be in the format of `A-Za-z0-9` and `string(30)`. If you handle the settlement, Swedbank Pay will send the `payeeReference` and it will be limited to the format of `string(12)`. All characters must be digits.
`payeeName`	`string`	The payee name (like merchant name) that will be displayed when redirected to Swedbank Pay.
`productCategory`	`string(50)`	A product category or number sent in from the payee/merchant. This is not validated by Swedbank Pay, but will be passed through the payment process and may be used in the settlement process. You therefore need to ensure that the value given here is valid in the settlement.
`orderReference`	`string(50)`	The order reference should reflect the order reference found in the merchant’s systems.

Payee Reference

The payeeReference is used as a receipt/invoice number when the payer chooses to pay with Invoice Payments. The specific processing rules are described below.

It must be unique for every operation, used to ensure exactly-once delivery of a transactional operation from the merchant system.
It must be in digits and/or letters (excluding - and no special characters), and be within string(30).

The payeeReference given when creating transactions and payments has some specific processing rules depending on specifications in the contract.

It must be unique for every operation, used to ensure exactly-once delivery of a transactional operation from the merchant system.
Its length and content validation is dependent on whether the transaction.number or the payeeReference is sent to the acquirer.
1. If you select Option A in the settlement process (Swedbank Pay will handle the settlement), Swedbank Pay will send the transaction.number to the acquirer and the payeeReference must be in the format of characters A-Za-z0-9 and string(30).
2. If you select Option B in the settlement process (you will handle the settlement yourself), Swedbank Pay will send the payeeReference to the acquirer and it will be limited to the format of string(12) and all characters must be digits.