Creating a Token on Behalf of Another Party

When contractually granted permission by Token.io, you can create a token on behalf of another party by configuring the ActingAs field in the token payload with the following properties identifying the intended recipient of the token.

Properties of the ActingAs Field
Field Description Required/ Optional
refId TPP's discretionary reference identification of the recipient; opaque to Token.io Optional
displayName Name of recipient shown to user Required*
logoUrl URL point to recipient's logo Optional
secondaryName Domain or email address of recipient shown to user along with display_name Optional
* Required when specifying ActingAs, although ActingAs is otherwise entirely optional.

Here's an example of the code block:

Java  JavaScript  C#  

tokenRequest.setActingAs(ActingAs.newBuilder()

    .setDisplayName(displayName)

    .setRefId(refId)

    .setLogoUrl(logoUrl)

    .setSecondaryName(secondaryName));

Add ActingAs to a new transfer or access token request as appropriate.