v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB

Attribute

Store user attributes

This POST endpoint is used to store user attributes, allowing you to associate additional data with a user token. <br> To use this endpoint, you need to provide the user_token, endpoint_token, and currency as parameters in the URL Path. You also need to provide the attribute values as JSON parameters in the Request body. <br> If existing attributes are already stored for the user, this call will override their values.

post/attribute/{user_token}/{endpoint_token}/{currency}

Path parameters

user_tokenstring required

Token representing the user to store attributes for

endpoint_tokenstring required

Token representing the transaction endpoint — either the destination_token for payouts (e.g., MassPay → Brazil → Bank Deposit → Itau), or the origin_token for pay-ins. For payouts, this value is retrieved from the country services endpoint.

Headers

Idempotency-Keystring

Unique key to prevent duplicate processing

Request body

attr_set_tokenstring

The token that represents a set of attributes for a specific payer. Optional, specify the value if you're trying to add a value for a specific attributes set. If the existing values associated with the attr_set_token are different, this value will be ignored and a new attr_set_token would be issued.

labelstring

Optional user-defined label for identifying or naming this set of attributes. Useful for UI display or future reference.

Example request

{
  "values": [
    {
      "token": "e2ca24e9-c546-4c64-90d2-cb8e70e7c9ba",
      "value": "432532532"
    }
  ],
  "attr_set_token": "attr_set_e2ca24e9-c546-4c64-90d2-cb8e70e7c9ba",
  "label": "JPMorgan Chase"
}

Response

Succesfully created.

attr_set_tokenstring required

attr_set_token associated with the stored attributes