GET
/
payinLinks
/
{payinLinkId}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

Unique identifier of the payin link.

Response

200 - application/json
amount
number

The total amount to be paid in COP.

amountCollected
number

The amount that has been collected in COP.

createdAt
string

ISO string representing when the Payin Link was created.

customerDetails
object
customerId
string

The ID of the customer for whom the Payin Link is created.

description
string

Description of the Payin Link.

expiration
string

Datetime when link will expire in YYYY-MM-DDTHH:mm:ss format. By default, expiration is at the end of the day after the link creation. Minimum expiration is the current date and maximum expiration is at the end of the 7th day from creation. Links expire shortly after the specified datetime has passed.

fee
number

Any fee associated with the Payin Link.

id
string

Unique identifier for the Payin Link.

paymentUrl
string

URL to which the customer can go to complete the payment.

redirectUrl
string

URL to which the customer will be redirected after the payment process.

reference
string

An optional reference provided by the merchant to identify the Payin Link.

status
enum<string>

The current status of the Payin Link.

Available options:
pending,
processing,
approved,
cancelled
statusMessage
enum<string>

Additional detail on the status. Only present when status is "cancelled".

Available options:
AUTHENTICATION_FAILED,
CUSTOMER_CANCELLATION,
DECLINED_BY_BANK,
EXPIRED,
INVALID_ACCOUNT,
NOT_ENOUGH_FUNDS,
ERROR
targetMerchantAccountId
string

Account ID of the target merchant account for this Payin Link.

type
enum<string>

The type of Payin Link

Available options:
general,
pse,
bancolombiaButton,
nequiButton,
card,
bancolombiaCollect
updatedAt
string

ISO string representing when the Payin Link was last updated.