Reorder Payment Methods

POST

/api/members/{memberId}/payment-methods/reorder

curl --request POST \
  --url https://example.com/api/members/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/payment-methods/reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "memberId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "merchantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "orderedIds": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ] }'

Sets the member’s fallback ranking. The biller tries methods in this order, so the first id becomes the default/primary instrument. Send the full set of the member’s method ids in the desired order.

POST /api/members/{memberId}/payment-methods/reorder
{ "orderedIds": ["...", "..."] }

Authorizations

• Bearer

Parameters

Path Parameters

memberId

required

string format: uuid

Request Body

object

memberId

string format: uuid

merchantId

string format: uuid

orderedIds

Array<string>

nullable

Example ^generated

{
  "memberId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "merchantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "orderedIds": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ]
}

object

memberId

string format: uuid

merchantId

string format: uuid

orderedIds

Array<string>

nullable

Example ^generated

{
  "memberId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "merchantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "orderedIds": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ]
}

object

memberId

string format: uuid

merchantId

string format: uuid

orderedIds

Array<string>

nullable

Example ^generated

{
  "memberId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "merchantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "orderedIds": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ]
}

Responses

204

Ranking updated.

400

The id list doesn’t exactly match the member’s methods.

Media type application/json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}