Create an account link

post

https://pg-staging.maya.ph/accounts/links

This API is used to create an account link ID based on the type provided.

⚠️ For Basic Authentication, use PUBLIC API KEY. Learn more →

Body Params

requestReferenceNumber

string

required

length between 1 and 36

The merchant's own reference number for the account link. It is recommended that every attempt to create an account link bears a unique request reference number.

type

string

enum

required

The type of the link attempted to be created. The only supported value for this is 'maya'.

Allowed:

redirectUrls

object

required

Contains the list of URLs that the merchant nominates for the web client to redirect to after an attempt to authorize an account link.

accountUserId

string

length between 1 and 1000

For type 'maya', this is the Maya Account phone number in E.164 international format.

userCustomizations

object

Contains a list of user-experience customization properties that the merchant can set.

Headers

Maya-Signature

string

Contains signature information that is used to validate the integrity of the request. Only required if your integration is configured with Maya-Signature.

Responses

200Successful creation of account link

400Failure in account link creation