Auth Links
1 endpoint. Base URL https://api.paymentsonline.io, sandbox https://api.sandbox-paymentsonline.io.
Every request needs payments-api-key and payments-account.
/v1/auth-linksCreate an Auth Link
Creates an Auth Link for a User.
Header parameters
payments-accountstringrequiredThe id of the Paydude Account (usually starting with the prefix
acct_) that the request is performed on behalf of. Must be a merchant (connected) account id, not the partner account you signed up with; a partner account passes GET /v1/accounts and then fails with "not enabled for this account" on the first payment call.
Request body application/jsonrequired
expirationstringrequiredExpiration of the Auth Link (i.e.. 1d, 7d, 30d). Value must be between 0d and 30d.
metadataobjectoptionalSet of [key-value pairs](#section/Metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value (i.e.
''ornull) to them. All keys can be unset by posting an empty value (i.e.{}ornull) tometadata.redirect_urlstringoptionalThe console url to redirect the user to after authenticating. Defaults to /dashboard if not provided.
user_idstringrequiredThe id of the user.
Responses
201AuthLinkDto
account_idstringrequiredThe account id of the user that can authenticate with this auth link.
created_atstring date-timerequiredTime at which the auth link was created.
expires_atstring date-timeoptionalThe expiration date of this auth link.
idstringrequiredThe id of the auth link.
metadataobjectoptionalSet of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value (i.e.
''ornull) to them. All keys can be unset by posting an empty value (i.e.{}ornull) tometadata."redeemedbooleanrequiredIndicates whether this auth link has been redeemed.
redirect_urlstringoptionalThe console url to redirect the user to after authenticating. Defaults to /dashboard if not provided.
updated_atstring date-timerequiredTime at which the auth link was last updated.
urlstringrequiredThe url to use for authenticating via auth link.
user_idstringrequiredThe id of the user that can authenticate with this auth link.
