Get profile

/payment_profile/find

Target audience: Developers

Release version: 4.5.6

Find payment profile

Introduction

This endpoint fetches a single payment profile for the supplied account, based on given search criteria.

URI

Environment	URI
Stage	https://payway-api.stage.adeprimo.se/external/api/v1/payment_profile/find
Production	https://backend.worldoftulo.com/external/api/v1/payment_profile/find

Requirements

Identity	Scope
No	/external/payment_profile/r

Parameters

You are required to supply either order_id or id.

Field	Required	Type	Description
account_id	Yes	String	The id of the account Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i".
id	No	String	The id of the payment profile Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i".
order_id	No	String	Gets profile (if any) for the specified order: Allowed values: /\A[A-Z0-9]+-[0-9]+$/

Curl examples

By id

curl --request GET \
  --url https://payway-api.stage.adeprimo.se/external/api/v1/me/payment_profile/find?account_id=7273a2c309c04cf2178b4c50&id=6273a2c309c04cf2178b4c50 \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <access_token_with_identity>'

By order_id

curl --request GET \
  --url https://payway-api.stage.adeprimo.se/external/api/v1/me/payment_profile/find?account_id=7273a2c309c04cf2178b4c50&order_id=ORDER-123 \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <access_token_with_identity>'

Response

HTTP 200 OK
{
  "item": {
    "id": "6273a2c309c04cf2178b4c50",
    "account_id": "6273a1a609c04ceec7409c99",
    "type": "adyen_scheme",
    "default_profile": false,
    "visible": true,
    "state": "activated",
    "meta_data": {
      "masked_number": "123***123",
      "expiry_month": "04",
      "expiry_year": "2023",
      "brand": "VISA"
    },
    "agreements": [
      "ORDER-123",
      "ORDER-456"
    ]
  }   
}

Note

visible is a boolean indicating whether the payment profile should be displayed to the customer. It always returns true or false (defaulting to true for profiles created before this flag existed). It can be changed via the Set visibility endpoint, and is gated by the enable_payment_profile_visibility rule.

Errors

This API uses the common error conventions of the Payway API

See common error responses