Payment Link From Invoice ID [V3]
This API will return the Payment link data by passing the invoice id used for creating the payment link.
Path Parameters
The invoice_id for which the payment link has to be fetched
- 200
- 4XX
- 5XX
if there exists a payment link with given invoice_id, the response will be as below
Schema
- Array [
- ]
Possible values: [created
, sent
, opened
, paid
, cancelled
, expired
]
The status of payment link
This is the currency code in ISO-4217 format
The amount to be paid via payment link
The amount paid via payment link
This is the unique hash generated for each payment link.
This is your internal unique reference identifier for this payment link
This will be true if the payment link was sent via SMS to user.
This will be true if the payment link was sent via email to user.
timestamp at which the payment link was created in YYYY-MM-DD HH:MM:SS.MS format.
timestamp at which link will expire in YYYY-MM-DD HH:MM:SS.MS format.
payer_info object
This is the email address of your consumer
This is the first name of your consumer
This is the last name of your consumer
This is the mobile number of your consumer, default country code is +91.
payment link signature generated at our end
product_details object
This is the title of the product that is being sold
This is the detailed description of the product being sold
This is the public URL from which the image of the product can be fetched
This is the currency code in ISO-4217 format
This is the quantity that is being purchased
This is the rate * quantity i.e. the amount before tax
This is the tax amount on the cart item
This is the sum of amount before tax and the tax amount
transaction object[]
This is the transaction_id returned by Nimbbl in response to the create order API
Possible values: [pending
, succeeded
, failed
, reversed
, reversing
]
This is the status of the order
Amount of the transaction
Type of transaction (payment, refund)
This is the currency code in ISO-4217 format
This is the payment partner through which the payment has been processed
Additional charges for the transaction
This is amount that will be discounted as per the offers that have been configured by you
This is the unique offer id provided by Nimbbl, it can be used in subsequent API calls
This is the transaction reference generated by the payment partner
{
"payment_link_status": "open",
"payment_link_currency": "INR",
"payment_link_amount": 10,
"payment_link_amount_paid": 5,
"payment_link_hash": "8adBybXd1",
"payment_link_invoice_id": "inv_asjjeibdhakk49hnek3",
"sms_sent": true,
"email_sent": true,
"created_at": "2023-10-18 14:30:14.685635",
"link_expiry": "2023-12-18 17:35:11.685635",
"payer_info": {
"payer_email_address": "wonderwoman@themyscira.gov",
"payer_first_name": "Diana",
"payer_last_name": "Prince",
"payer_mobile_number": "9876543210"
},
"payment_link_signature": "dfab2195d0c89eb24d62ab8a6fe578921f1d42037f221ee6a6950535fd637e09",
"product_details": {
"title": "Best Sliced Alphonso Mango",
"description": "The Alphonso mango is a seasonal fruit harvested from mid-April through the end of June. The time from flowering to harvest is about 90 days, while the time from harvest to ripening is about 15 days.The fruits generally weigh between 150 and 300 grams (5.3 and 10.6 oz), have a rich, creamy, tender texture and delicate, non-fibrous, juicy pulp. As the fruit matures, the skin of an Alphonso mango turns golden-yellow with a tinge of red across the top of the fruit",
"image_url": "https://en.wikipedia.org/wiki/Alphonso_mango#/media/File:Alphonso_mango.jpg",
"currency": "INR",
"quantity": 2,
"amount_before_tax": 2100,
"tax": 105,
"total_amount": 2205
},
"transaction": [
{
"transaction_id": "o_BrbcdefghAD7zg-246445270",
"status": "succeeded",
"transaction_amount": 105,
"transaction_type": "string",
"transaction_currency": "INR",
"payment_partner": "Razorpay",
"additional_charges": 5,
"offer_discount": 100,
"offer_id": "string",
"psp_transaction_id": "ajndkka_223455"
}
]
}
When the payment link creation request is not successful, the response will be as below
Schema
error object
This is the error_code generated by Nimbbl
This is a customer friendly message that can be displayed to your consumer
This explains to your team how to recover from the error
{
"error": {
"nimbbl_error_code": "INVALID_REQUEST_PARAMETER",
"nimbbl_consumer_message": "Sorry, your payment cannot be processed due to a technical error. Please try again after some time.",
"nimbbl_merchant_message": "There is an input validation error, please check the payload of your request."
}
}
When there is a problem on the server, the response will be as below
Schema
error object
This is the error_code generated by Nimbbl
This is a customer friendly message that can be displayed to your consumer
This explains to your team how to recover from the error
{
"error": {
"nimbbl_error_code": "INVALID_REQUEST_PARAMETER",
"nimbbl_consumer_message": "Sorry, your payment cannot be processed due to a technical error. Please try again after some time.",
"nimbbl_merchant_message": "There is an input validation error, please check the payload of your request."
}
}