Initiate a payment link transaction

Here we discuss how you initiate a payment link transaction. A payment link transaction is fundamentally a normal transaction except that this time, it is created within the scope of a Payment Link.

To create a transaction, we must collect the details of the customer and the cryptocurrency in which the customer would prefer to make the payment.

POST https://api.ivorypay.io/v1/payment-links/:id/transactions

Path Parameters

Name	Type	Description
id*	String	The ID of the payment link

Request Body

Name	Type	Description
firstName	String	The first name of the customer
lastName	String	The last name of the customer
email	String	The email address of the customer
cryptocurrency	String	The cryptocurrency in which payment is to be made. Supported values include USDT, USDC and SOL.

200: OK Success

{
    "success": true,
    "message": "Transaction was initiated successfully",
    "data": {
        "id": "086e3492-679c-4867-aa0a-b755d07ac940",
        "email": "[e-mail]",
        "address": "C26ThRAFrGzkzRTsDoYSNA6CVLPxA37xwsfFwbf3gMVS",
        "reference": "O9qfaNsnm094Gkfqv2wpbou4w8vy1u0r",
        "expectedAmountInUSD": 0.25,
        "expectedAmountInCrypto": 0.25,
        "feeInCrypto": 0.0025,
        "expectedAmountWithFeeInCrypto": 0.2525,
        "crypto": "USDC",
        "baseFiat": "NGN",
        "baseFiatToUSDRate": 0.002,
        "usdToCryptoRate": 0.9999
    }
}

400: Bad Request Invalid data

{
    "success": false,
    "message": "Invalid data",
    "statusCode": 400,
    "errors": [],
    "timestamp": "10/2/2022, 9:47:43
}

After initiating the payment link transaction, the rules remain the same to Initiating a regular transaction.