Payment

The Payment module lists cards and payment modes, allows for the selection of payment modes during checkout, handles refunds, validates customers, and ensures the security of transactions.

Beneficiary

Beneficiary for a refund refers to the individual or entity who will receive the refunded amount. This could be the original purchaser of the product or service, or it could be someone else if the refund is being processed on their behalf.

Operations
GET
/service/application/payment/v1.0/refund/user/beneficiary
# Retrieve beneficiary details
GET

Retrieve beneficiary details

Get beneficiaries associated with the user for processing refunds, based on the provided order ID.
Parameters
order_id
string
Required
A unique number used for identifying and tracking your orders.
Response
200
400
Success. Returns the details of the beneficiary getting a refund.
OrderBeneficiaryFetchDetails
show_beneficiary_details
boolean
Show beneficiary details or not.
beneficiaries
array of object (OrderBeneficiaryDetails)
Nullable
All Beneficiaries Of An Order.
Array of OrderBeneficiaryDetails
modified_on
string
| date-time
Modification Date of Beneficiary.
account_no
string
Account Number.
mobile
string
Mobile no of User.
bank_name
string
Bank Name Of Account.
ifsc_code
string
Ifsc Code Of Account.
is_active
boolean
Boolean Flag whether Beneficiary is active or not.
beneficiary_id
string
Beneficiary Id.
account_holder
string
Account Holder Name.
email
string
EMail of User.
delights_user_name
string
Nullable
User Id Who filled the Beneficiary.
id
integer
| int32
Id of the Order Beneficiary.
transfer_mode
string
Transfer Mode Of Account.
branch_name
string
Branch Name Of Account.
created_on
string
| date-time
Creation Date of Beneficiary.
subtitle
string
SHort Title Of Account.
comment
string
Remarks.
address
string
Address of User.
title
string
Title Of Account.
display_name
string
Display Name Of Account.
Examples
Parameters
order_id:
"FY65C2797B2F00FCF07E"
GET
/service/application/payment/v1.0/refund/user/beneficiary
Loading...
Response
Loading...

Card

Payment cards eases the process of payment for orders. Customers can securely save multiple payment cards within the payment gateway. During payment of an order, the list of payment options will show the list of saved cards. Link cards to customers, fetch active tokenized card information, tokenize and save cards after customer consent, and remove customer's cards from the payment gateway.

Operations
POST
/service/application/payment/v1.0/card/attach
# Link payment card to customer
GET
/service/application/payment/v1.0/card/aggregator
# Retrieve active card aggregator
GET
/service/application/payment/v1.0/cards
# Get customer cards
POST
/service/application/payment/v1.0/card/remove
# Delete customer card
GET
/service/application/payment/v1.0/cards/info/{card_info}
# Get card details
POST

Link payment card to customer

Link payment card to a user account for seamless transactions. Upon successful linking, the card becomes associated with the user's profile, enabling secure and convenient payments.
Parameters
No Parameters
Request body
nickname
string
Nickname of the card holder.
Default Value :
refresh
boolean
Nullable
Refresh cache flag.
card_id
string
Required
Card token of payment gateway.
name_on_card
string
Name of the card holder.
Default Value :
Response
200
400
Success.
AttachCardsDetails
data
object
List of cards of customer.
success
boolean
Response is successful or not.
message
string
Human readable message.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/card/attach
Loading...
Response
Loading...
GET

Retrieve active card aggregator

Get details about the active card aggregator used by the user, including the aggregator name.You can refresh the data by setting the 'refresh' parameter to true if needed.
Parameters
refresh
boolean
Select `true` to remove temporary cache files on payment gateway and replace with the latest one.
Default Value : false
Response
200
400
Success. Returns an active payment gateway.
ActiveCardPaymentGatewayDetails
cards
object (CardPaymentGateway)
CardPaymentGateway
api
string
Nullable
Payment gateway CARD api endpoint.
aggregator
string
Payment gateway name.
customer_id
string
Nullable
Aggregator customer id.
success
boolean
Response is successful or not.
message
string
Human readable message.
Examples
Parameters
refresh:
true
GET
/service/application/payment/v1.0/card/aggregator
Loading...
Response
Loading...
GET

Get customer cards

List all active cards saved by the user.Includes details such as the card's aggregator name, card ID, token, reference, number, expiration date, type, issuer, brand, nickname, and whether it has expired.
Parameters
force_refresh
boolean
Select `true` to clear the cache.
Default Value : false
Response
200
400
Success. Returns a list of cards saved by the user.
ListCardsDetails
data
array of object (Card)
List of cards of customer.
Array of Card
card_number
string
Nullable
Card number mentioned on the card.
card_name
string
Nullable
Name mentioned on the card.
card_type
string
Nullable
Type of the card.
card_brand_image
string
| url
Nullable
Brand image on the card.
card_reference
string
Nullable
Card reference.
card_issuer
string
Nullable
Issuer of the card.
card_brand
string
Nullable
Brand of the card.
expired
boolean
Nullable
Card expiry.
compliant_with_tokenisation_guidelines
boolean
Nullable
Whether card is tokenized or not.
card_isin
string
Nullable
International Securities Identification Number for the card.
exp_year
integer
| int32
Nullable
Card's expiration year.
nickname
string
Nullable
User-defined name for the card.
aggregator_name
string
Name of the payment aggregator.
card_fingerprint
string
Nullable
Unique fingerprint of the card for identification.
card_token
string
Nullable
Encrypted token representing the card.
exp_month
integer
| int32
Nullable
Card's expiration month.
card_id
string
Nullable
Unique identifier for the card saved at aggregators end.
success
boolean
Response is successful or not.
message
string
Human readable message.
Examples
Parameters
force_refresh:
true
GET
/service/application/payment/v1.0/cards
Loading...
Response
Loading...
POST

Delete customer card

Delete payment card from the user's account.
Parameters
No Parameters
Request body
card_id
string
Required
Card token of payment gateway.
Response
200
400
Success. Returns a success message if card is deleted.
DeleteCardsDetails
success
boolean
Response is successful or not.
message
string
Nullable
Human readable message.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/card/remove
Loading...
Response
Loading...
GET

Get card details

Get details of a specified payment card, including information such as the card type, brand, country, and expiration date.
Parameters
card_info
string
Required
Card first 6 digit IIN(prefix) number.
aggregator
string
This is a string value describing the aggregator name.
Default Value : juspay
Response
200
400
Success. Returns the status of payment.
CardDetailsFetchedDetails
data
object (CardDetails)
CardDetails
status
boolean
Current status of the card.
country
string
Country where the card was issued.
bank_code
string
Code identifying the bank.
id
string
Unique identifier for the record.
card_exp_year
string
Card's expiration year.
card_brand
string
Brand of the card (e.g., Visa, MasterCard).
type
string
General type of the card (e.g., debit, credit).
card_sub_type
string
Sub-type of the card (e.g., Platinum, Gold).
is_domestic_card
boolean
Indicates whether the card is domestic.
name_on_card
string
Name of the cardholder.
card_exp_month
string
Card's expiration month.
extended_card_type
string
Extended type of the card, providing more specific classification.
card_object
string
Object representation of the card.
card_token
string
Encrypted token representing the card.
user
string
User associated with the card.
bank
string
Bank associated with the card.
success
boolean
Response is successful or not.
Examples
Parameters
card_info:
"529992"
aggregator:
"razorpay"
GET
/service/application/payment/v1.0/cards/info/{card_info}
Loading...
Response
Loading...

Order

Order refers to a formal request made by a customer to purchase one or more products or services from the website's catalog. orders feature lets users easily start new transactions. It helps manage pending orders by providing key details like unpaid amounts and order statuses. Additionally, it offers detailed info on completed orders that have been successfully paid for.

Operations
GET
/service/application/payment/v1.0/payment/outstanding-orders/
# Outstanding orders
GET
/service/application/payment/v1.0/payment/paid-orders/
# Retrieve details of paid orders
POST
/service/application/payment/v1.0/payment-orders/
# Create Order
GET

Outstanding orders

Get details of orders with outstanding payments.
Parameters
aggregator
string
Merchant user ID as value.
Response
200
400
Success. Returns the status of API.
OutstandingOrderDetails
status_code
integer
| int32
HTTP status code.
data
array of object
Nullable
Dict containing the outstanding order details.
success
boolean
Response is successful or not.
message
string
Nullable
Message.
Examples
Parameters
aggregator:
"value"
GET
/service/application/payment/v1.0/payment/outstanding-orders/
Loading...
Response
Loading...
GET

Retrieve details of paid orders

Get details of orders that have been paid for, including shipment ID, order ID, due date, payment date, amount, and transaction ID, based on the aggregator merchant user ID.
Parameters
aggregator
string
Merchant user ID as value.
Response
200
400
Success. Returns the status of API.
PaidOrderDetails
status_code
integer
| int32
HTTP status code.
data
array of object
Nullable
Dict containing the paid order details.
success
boolean
Response is successful or not.
message
string
Nullable
Message.
Examples
Parameters
aggregator:
"value"
GET
/service/application/payment/v1.0/payment/paid-orders/
Loading...
Response
Loading...
POST

Create Order

Create an order and payment on the aggregator side.
Parameters
No Parameters
Request body
payment_methods
array of object (PaymentOrderMethods)
All payment methods for order.
Array of PaymentOrderMethods
amount
number
| float
Required
Amount to be collected.
payment
string
Payment type i.e. Required / Blocked.
mode
string
Required
Payment mode.
meta
object (PaymentMethodsMetaOrder)
Required
PaymentMethodsMetaOrder
merchant_code
string
Required
Merchant code.
payment_gateway
string
Required
Payment gateway name.
payment_identifier
string
Required
Payment identifier.
name
string
Required
Payment mode name.
order_id
string
Required
Order id.
shipment_id
string
Shipment_id.
Response
200
400
Success. Check the example shown below
PaymentOrderDetails
payment_confirm_url
string
Nullable
Payment confirm url for aggregator.
callback_url
string
Nullable
Callback url for aggregator.
order_id
string
Nullable
Merchant order id.
success
boolean
Successful or failure.
status_code
integer
| int32
HTTP status code.
data
object (PaymentOrderData)
PaymentOrderData
amount
number
| float
Nullable
Amount.
aggregator
string
Nullable
Aggregator name.
callback_url
string
Nullable
Callback url for aggregator.
order_id
string
Nullable
Aggregator order id.
customer_id
string
Nullable
Aggregator customer id.
merchant_order_id
string
Nullable
Merchant order id.
currency
string
Nullable
Currency used for the order.
email
string
Nullable
Email address of the customer.
contact
string
Nullable
Contact number of the customer.
method
string
Nullable
Method of payment or delivery for the order.
message
string
Detailed message.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment-orders/
Loading...
Response
Loading...

Paylater

PayLater, also known as "Buy Now, Pay Later" (BNPL), is a payment method that allows customers to make purchases and defer payment for those purchases to a later date. With PayLater, customers can buy products or services immediately and then repay the amount owed over time, typically in installments. Efficiently retrieve repayment transaction details, initiate merchant onboarding for BNPL, and Validate Customer Eligibility for Paylater Payment Options.

Operations
POST
/service/application/payment/v1.0/payment/customer/validation
# Verify payment customer
POST
/service/application/payment/v1.0/payment/confirm/charge
# Verify order confirmation and charge
POST
/service/application/payment/v1.0/payment/validate/customer-credits-v2
# Verify payment customer and show credit summary
POST

Verify payment customer

Verify if the user is eligible for pay-later payment from the payment aggregator side using the customer's phone number.
Parameters
No Parameters
Request body
aggregator
string
Required
Payment gateway name in camelcase i.e Simple, Rupifi.
transaction_amount_in_paise
integer
| int32
Required
Payable amount in paise.
phone_number
string
Required
User mobile number without country code.
billing_address
object
billing address
order_items
array of object
order items
payload
string
Nullable
Hashed payload string.
merchant_params
object
merchant parameters, these will be used for customer approaval i.e order-id, restaurant-address, delivery latitude and longitude
delivery_address
object
delivery addresses
Response
200
400
Success.
ValidateCustomerDetails
data
object
Payment gateway response data.
success
boolean
Response is successful or not.
message
string
Error or success message.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/customer/validation
Loading...
Response
Loading...
POST

Verify order confirmation and charge

Verify the payment status and charge from the customer's BNPL (Buy Now, Pay Later) account after order confirmation.
Parameters
No Parameters
Request body
verified
boolean
Nullable
Already Verified flag from payment gateway i.e Mswipe.
aggregator
string
Required
Payment gateway name i.e Simpl, Mswipe.
order_id
string
Required
Merchant order id i.e. FY670260630EA88A8FD5
transaction_token
string
Nullable
Transaction token of payment gateway.
amount
integer
| int32
Required
Chargeable amount of order.
Response
200
400
Success.
ChargeCustomerDetails
status
string
Status of charged payment.
cart_id
string
Nullable
Cart id of customer.
success
boolean
Response is successful or not.
aggregator
string
Payment gateway name i.e Simpl, Mswipe.
message
string
Human readable message.
order_id
string
Merchant order id i.e. FY670260630EA88A8FD5
delivery_address_id
string
Nullable
Delivery address id of customer.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/confirm/charge
Loading...
Response
Loading...
POST

Verify payment customer and show credit summary

Verify if the user is eligible for payment and also show credit summary if activated.
Parameters
No Parameters
Request body
aggregator
string
Required
Aggregator name of the payment gateway.
transaction_amount
number
| float
Required
Payable amount
cart_id
string
Unique identifier for the shopping cart.
Response
200
400
Success. Check the example shown below or refer `ValidateCustomerCreditSchema` for more details.
ValidateCustomerCreditSchema
success
boolean
Successful or failure of API
is_eligible
boolean
The customer is eligible to make a transaction or not
is_applied
boolean
Credit is applied to the user's account or not
message
string
Detailed message about the user credt eligibility.
cart_id
string
Unique identifier for the shopping cart.
account
object (CreditAccountSummary)
CreditAccountSummary
account_id
string
Unique identifier associated with the customer's account
status
string
Current state of the account, indicating whether it is ACTIVE, INACTIVE, or UNREGISTERED.
Enum
redeemable_balance
object (UserCreditSchema)
UserCreditSchema
amount
number
| float
The monetary value, which can represent available balance, redeemed balance, or hold amount, depending on the context.
currency
string
The currency code (e.g., INR, USD).
unique_id
string
A unique identifier for the payment transaction.
available_balance
object (UserCreditSchema)
UserCreditSchema
amount
number
| float
The monetary value, which can represent available balance, redeemed balance, or hold amount, depending on the context.
currency
string
The currency code (e.g., INR, USD).
unique_id
string
A unique identifier for the payment transaction.
amount_on_hold
object (UserCreditSchema)
UserCreditSchema
amount
number
| float
The monetary value, which can represent available balance, redeemed balance, or hold amount, depending on the context.
currency
string
The currency code (e.g., INR, USD).
unique_id
string
A unique identifier for the payment transaction.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/validate/customer-credits-v2
Loading...
Response
Loading...

Payment

Payment system refers to the mechanism by which customers can securely and conveniently pay for the products or services they wish to purchase. It involves integrating various payment methods such as credit/debit cards, digital wallets, bank transfers, and sometimes cash on delivery (COD) to accommodate different customer preferences.It typically involves - Payment Gateway Integration: Connecting the website to payment gateways like PayPal, Stripe, or other third-party processors to facilitate online transactions securely. Secure Transactions: Implementing encryption protocols and secure socket layers (SSL) to protect customers' payment information from unauthorized access or cyber threats. Multiple Payment Options: Offering diverse payment methods to cater to a wide range of customers, including credit/debit cards, digital wallets (e.g., Apple Pay, Google Pay), and alternative methods like cryptocurrencies or buy-now-pay-later services. Checkout Process: Streamlining the checkout process to minimize friction and make it easy for customers to complete their purchases swiftly. Payment Confirmation: Providing instant confirmation of successful payments and sending receipts or order confirmations to customers via email or SMS.

Operations
GET
/service/application/payment/v1.0/config/aggregators/key
# Get payment aggregators
POST
/service/application/payment/v1.0/payment/request
# Start payment process
POST
/service/application/payment/v1.0/payment/confirm/polling
# Update payment status
GET
/service/application/payment/v1.0/payment/options
# Get payment modes
GET
/service/application/payment/v1.0/payment/options/pos
# POS payment modes
POST
/service/application/payment/v1.0/payment/options/wallet/link
# Initiate linking of wallet
POST
/service/application/payment/v1.0/payment/options/wallet/verify
# OTP verification
POST
/service/application/payment/v1.0/payment/options/wallet/delink
# Delink the wallet
POST
/service/application/payment/v1.0/payment/html/render/
# Render HTML
POST
/service/application/payment/v1.0/validate-vpa
# Validate VPA
GET
/service/application/payment/v1.0/payment/credit-summary/
# Credit summary
GET
/service/application/payment/v1.0/payment/redirect-to-aggregator/
# Redirects users to the payment aggregator's interface
GET
/service/application/payment/v1.0/check-credits/
# Verify credit availability and status
POST
/service/application/payment/v1.0/credit-onboard/
# Onboard customer for payment
GET

Get payment aggregators

Get aggregator secret key of all payment gateways utilized for payments when using the SDK for the payment gateway.
Parameters
refresh
boolean
Select `true` to remove temporary cache files on payment gateway and replace with the latest one.
Headers
x-api-token
string
Basic auth token.
Response
200
400
Success. Returns the keys of all payment gateways. Check the example shown below or refer `AggregatorsConfigDetail` for more details.
AggregatorsConfigDetail
success
boolean
Api response was successful or not.
razorpay
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
juspay
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
simpl
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
payumoney
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
rupifi
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
mswipe
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
stripe
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
ccavenue
object (AggregatorConfigDetail)
AggregatorConfigDetail
sdk
boolean
Nullable
Flag, whether to use sdk or not.
secret
string
Masked payment gateway api secret.
api
string
| url
Nullable
Payment gateway api endpoint.
pin
string
Nullable
Masked pin.
config_type
string
Fynd or self payment gateway.
Enum
merchant_key
string
Nullable
Unique merchant key.
verify_api
string
| url
Nullable
Payment gateway verify payment api endpoint.
key
string
Payment gateway api key.
user_id
string
Nullable
Registered User id.
merchant_id
string
Nullable
Unique merchant id.
env
string
Environment i.e Live or Test.
Examples
Parameters
refresh:
true
GET
/service/application/payment/v1.0/config/aggregators/key
Loading...
Response
Loading...
POST

Start payment process

Initiate the payment procedure for an order. Upon successful initiation, it returns a details including the success status, aggregator information, payment method, status, merchant order ID aggregator order , polling URL, timeout, virtual ID, Razorpay payment ID, customer ID, and device ID.
Parameters
No Parameters
Request body
razorpay_payment_id
string
Nullable
Payment gateway payment id.
method
string
Required
Payment method.
device_id
string
Nullable
EDC machine Unique Identifier.
aggregator
string
Required
Payment gateway name.
customer_id
string
Aggregator customer id.
contact
string
Required
Customer valid mobile number.
merchant_order_id
string
Required
Unique fynd order id.
vpa
string
Nullable
Customer vpa address.
order_id
string
Required
Payment gateway order id.
currency
string
Currency code.
timeout
integer
| int32
Nullable
Payment polling timeout if not received response in seconds.
amount
integer
| int32
Required
Payable amount.
email
string
| email
Required
Customer valid email.
Response
200
400
Success.
PaymentInitializationDetails
status
string
Status of payment.
razorpay_payment_id
string
Nullable
Payment id.
aggregator_order_id
string
Payment order id.
method
string
Payment method.
success
boolean
Response is successful or not.
upi_poll_url
string
Nullable
UPI poll url.
virtual_id
string
Nullable
Payment virtual address.
device_id
string
Nullable
EDC machine Unique Identifier.
polling_url
string
Polling url.
aggregator
string
Payment gateway name.
merchant_order_id
string
Order id.
customer_id
string
Nullable
Aggregator customer id.
vpa
string
Nullable
Customer vpa address.
currency
string
Nullable
Currency code.
timeout
integer
| int32
Nullable
Timeout in seconds for payment.
amount
integer
| int32
Nullable
Payable amount.
bqr_image
string
Nullable
Bharat qr image url.
status_code
string
Nullable
status code of the payment.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/request
Loading...
Response
Loading...
POST

Update payment status

Polling process to confirm the payment status. It periodically checks and updates the current status of a payment, ensuring timely and accurate confirmation of payment transactions.
Parameters
No Parameters
Request body
status
string
Required
Status of payment.
merchant_transaction_id
string
Unique fynd transaction id.
method
string
Required
Payment method.
device_id
string
Nullable
EDC machine Unique Identifier.
aggregator
string
Required
Payment gateway name.
customer_id
string
Aggregator customer id.
contact
string
Customer valid mobile number.
merchant_order_id
string
Required
Unique fynd order id.
vpa
string
Customer vpa address.
order_id
string
Required
Payment gateway order id.
currency
string
Currency code.
amount
integer
| int32
Nullable
Payable amount.
email
string
| email
Customer valid email.
razorpay_payment_id
string
Razorpay generated payment gateway transaction id, if aggregator is Razorpay
merchant_url
string
Redirect to this, upon payment success/fail, if method is PAYMENTLINK
Response
200
400
Success. Returns the status of payment.
PaymentStatusUpdateDetails
status
string
Payment status.
success
boolean
Nullable
Response is successful or not.
retry
boolean
Response is successful or not.
redirect_url
string
Nullable
Redirect url.
aggregator_name
string
Payment gateway name.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/confirm/polling
Loading...
Response
Loading...
GET

Get payment modes

Get available payment methods on the payment page, specifying the aggregator for each option, such as 'Netbanking powered by Juspay' and 'Card powered by Razorpay'.
Parameters
amount
integer
Required
Payable amount.
cart_id
string
Required
Identifier of the cart.
checkout_mode
string
Option to checkout for self or for others.
refresh
boolean
Select `true` to remove temporary cache files on payment gateway and replace with the latest one.
order_id
string
Identifier of the order, order_id.
card_reference
string
Card reference id of user's debit or credit card.
user_details
string
URLencoded JSON containing details of an anonymous user.
display_split
boolean
Display Split Payment Option or not.
advance_payment
boolean
Display Advance Payment Options or Normal.
shipment_id
string
Identifier of the shipment, shipment_id.
Response
200
400
Success. Returns all available options for payment. Check the example shown below or refer `PaymentModeRouteDetails` for more details.
PaymentModeRouteDetails
payment_options
object (PaymentOptionAndFlow)
PaymentOptionAndFlow
payment_option
array of object (RootPaymentMode)
Payment options.
Array of RootPaymentMode
is_pay_by_card_pl
boolean
Nullable
This flag will be true in case of Payment link payment through card.
add_card_enabled
boolean
Nullable
Save card option is allowed at backend or not, based on customer authentication and checkout mode.
display_priority
integer
| int32
Display Priority.
display_name
string
Payment mode display name.
list
array of object (PaymentModeList)
Payment mode.
Array of PaymentModeList
card_number
string
Nullable
Card number mentioned on the card.
merchant_code
string
Nullable
Unique code identifying the merchant.
card_reference
string
Nullable
Reference identifier for the card.
card_issuer
string
Nullable
Issuing bank or institution of the card.
compliant_with_tokenisation_guidelines
boolean
Nullable
Indicates compliance with tokenization guidelines.
code
string
Nullable
General code for identifying a transaction or status.
cod_limit
number
Nullable
Limit for Cash on Delivery (COD) transactions.
intent_flow
boolean
Nullable
Flow or process intended for the transaction.
fynd_vpa
string
Nullable
Virtual Payment Address (VPA) used by Fynd.
intent_app_error_dict_list
array of object (IntentAppErrorList)
Nullable
List of error dictionaries related to intent app.
Array of IntentAppErrorList
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
aggregator_name
string
Name of the payment aggregator.
card_fingerprint
string
Nullable
Unique fingerprint of the card for identification.
intent_app_error_list
array of string
Nullable
List of errors associated with the intent app.
intent_app
array of object (IntentApp)
Nullable
Application intended for handling the transaction.
Array of IntentApp
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
logos
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
display_name
string
Nullable
Display Name of the intent App.
expired
boolean
Nullable
Indicates whether the card is expired.
retry_count
integer
| int32
Nullable
Number of retry attempts.
exp_year
integer
| int32
Nullable
Card's expiration year.
exp_month
integer
| int32
Nullable
Card's expiration month.
card_id
string
Nullable
Unique identifier for the card saved at aggregators end.
remaining_limit
number
Nullable
Remaining available limit on the card.
display_priority
integer
| int32
Nullable
Priority of display in the user interface.
card_brand
string
Nullable
Brand of the card (e.g., Visa, MasterCard).
cod_limit_per_order
number
Nullable
Maximum limit per order for COD transactions.
logo_url
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
nickname
string
Nullable
User-defined name for the card.
card_name
string
Nullable
Name printed on the card.
card_type
string
Nullable
Type of the card (e.g., debit, credit).
card_brand_image
string
| url
Nullable
Image representing the card brand.
display_name
string
Nullable
Display name for the card in the user interface.
card_isin
string
Nullable
International Securities Identification Number for the card.
timeout
integer
| int32
Nullable
Timeout duration for transactions.
card_token
string
Nullable
Encrypted token representing the card.
name
string
Nullable
User's name.
meta
object
Nullable
Payment methods meta.
partial_payment_allowed
boolean
Indicates if this payment option is eligible for coupling with other payment options, allowing the user to make multi-method of payment (MOP) transactions.
save_card
boolean
Nullable
Card save or not.
aggregator_name
string
Nullable
Display Priority.
name
string
Payment mode name.
anonymous_enable
boolean
Nullable
Anonymous card flag.
payment_flows
object (PaymentFlow)
PaymentFlow
bqr_razorpay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
fynd
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
epaylater
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
razorpay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
juspay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
ajiodhan
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
simpl
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
rupifi
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
mswipe
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
stripe
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
ccavenue
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
payubiz
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
jiopay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
upi_razorpay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
payment_default_selection
object (PaymentDefaultSelection)
PaymentDefaultSelection
mode
string
Nullable
Default Selection Payment Mode.
identifier
string
Nullable
Identifier for Payment Mode.
skip
boolean
Nullable
Decide if the default payment mode will skip the payment options page altogether or just be preferred on the Frontend.
success
boolean
Response is successful or not.
payment_breakup
object
Payment Breakup for advance payment.
advance_payment
array of object (AdvancePaymentObject)
Nullable
Advance Payment Array.
Array of AdvancePaymentObject
name
string
Nullable
Name of Advance Payment Mode.
display_priority
number
| integer
Nullable
Display Priority for Payment Option.
payment_mode_id
number
| integer
Nullable
Payment Mode ID for Advance Payment Option.
display_name
string
Nullable
Display name for Advance Payment Mode.
list
array of object (PaymentModeList)
Nullable
Payment mode.
Array of PaymentModeList
card_number
string
Nullable
Card number mentioned on the card.
merchant_code
string
Nullable
Unique code identifying the merchant.
card_reference
string
Nullable
Reference identifier for the card.
card_issuer
string
Nullable
Issuing bank or institution of the card.
compliant_with_tokenisation_guidelines
boolean
Nullable
Indicates compliance with tokenization guidelines.
code
string
Nullable
General code for identifying a transaction or status.
cod_limit
number
Nullable
Limit for Cash on Delivery (COD) transactions.
intent_flow
boolean
Nullable
Flow or process intended for the transaction.
fynd_vpa
string
Nullable
Virtual Payment Address (VPA) used by Fynd.
intent_app_error_dict_list
array of object (IntentAppErrorList)
Nullable
List of error dictionaries related to intent app.
Array of IntentAppErrorList
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
aggregator_name
string
Name of the payment aggregator.
card_fingerprint
string
Nullable
Unique fingerprint of the card for identification.
intent_app_error_list
array of string
Nullable
List of errors associated with the intent app.
intent_app
array of object (IntentApp)
Nullable
Application intended for handling the transaction.
Array of IntentApp
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
logos
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
display_name
string
Nullable
Display Name of the intent App.
expired
boolean
Nullable
Indicates whether the card is expired.
retry_count
integer
| int32
Nullable
Number of retry attempts.
exp_year
integer
| int32
Nullable
Card's expiration year.
exp_month
integer
| int32
Nullable
Card's expiration month.
card_id
string
Nullable
Unique identifier for the card saved at aggregators end.
remaining_limit
number
Nullable
Remaining available limit on the card.
display_priority
integer
| int32
Nullable
Priority of display in the user interface.
card_brand
string
Nullable
Brand of the card (e.g., Visa, MasterCard).
cod_limit_per_order
number
Nullable
Maximum limit per order for COD transactions.
logo_url
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
nickname
string
Nullable
User-defined name for the card.
card_name
string
Nullable
Name printed on the card.
card_type
string
Nullable
Type of the card (e.g., debit, credit).
card_brand_image
string
| url
Nullable
Image representing the card brand.
display_name
string
Nullable
Display name for the card in the user interface.
card_isin
string
Nullable
International Securities Identification Number for the card.
timeout
integer
| int32
Nullable
Timeout duration for transactions.
card_token
string
Nullable
Encrypted token representing the card.
name
string
Nullable
User's name.
meta
object
Nullable
Payment methods meta.
partial_payment_allowed
boolean
Indicates if this payment option is eligible for coupling with other payment options, allowing the user to make multi-method of payment (MOP) transactions.
split
object (SplitObject)
Nullable
SplitObject
total_number_of_splits
number
| integer
Nullable
Maximum amount of splits allowed.
splits_remaining
number
| integer
Nullable
Number of splits remaining.
amount_remaining
number
| float
Nullable
Amount pending to be paid.
advance
object (AdvanceObject)
Nullable
AdvanceObject
is_active
boolean
Nullable
Is Advance Payment active.
amount
number
| float
Amount for Payment Breakdown.
time_unit
string
Nullable
Time unit for refunds.
description
string
Nullable
The description for Advance Payment (user configured).
display_name
string
Nullable
The display name for Advance payment.
prepayment_type
string
Nullable
Type of prepayment value.
prepayment_value
number
| float
Nullable
Value for prepayment in advance payment.
cancellation_type
string
Nullable
Type of cancellation.
refund_time_limit
number
| float
Nullable
Time limit for processing refund.
all_prepayment_type
array of string
Nullable
All available types of prepayment.
allow_custom_advance_amount
boolean
Nullable
Is custom advance amount allowed?.
Examples
Parameters
amount:
1000
cart_id:
"4234324234"
checkout_mode:
"self"
refresh:
true
order_id:
"FY65C47E27CB249F378C"
card_reference:
"1"
user_details:
"%7B%22first_name%22:%22Fynd%22,%22last_name%22:%22Dummy%22,%22mobile%22:%229999999999%22,%22email%22:%22paymentsdummy@gofynd.com%22%7D"
shipment_id:
"12345"
GET
/service/application/payment/v1.0/payment/options
Loading...
Response
Loading...
GET

POS payment modes

Get available payment methods on the payment page for POS, specifying the aggregator for each option, such as 'CARD powered by Juspay' and 'QR powered by Razorpay'.
Parameters
amount
integer
Required
Payable amount.
cart_id
string
Required
Identifier of the cart.
pincode
string
Required
The PIN Code of the destination address, e.g. 400059.
checkout_mode
string
Option to checkout for self or for others.
refresh
boolean
Select `true` to remove temporary cache files on payment gateway and replace with the latest one.
card_reference
string
Card reference id of user's debit or credit card.
order_type
string
Required
The order type of shipment HomeDelivery - If the customer wants the order home-delivered PickAtStore - If the customer wants the handover of an order at the store itself.
user_details
string
URLencoded JSON containing details of an anonymous user.
Response
200
400
Success. Returns all available options for payment. Check the example shown below or refer `PaymentModeRouteDetails` for more details.
PaymentModeRouteDetails
payment_options
object (PaymentOptionAndFlow)
PaymentOptionAndFlow
payment_option
array of object (RootPaymentMode)
Payment options.
Array of RootPaymentMode
is_pay_by_card_pl
boolean
Nullable
This flag will be true in case of Payment link payment through card.
add_card_enabled
boolean
Nullable
Save card option is allowed at backend or not, based on customer authentication and checkout mode.
display_priority
integer
| int32
Display Priority.
display_name
string
Payment mode display name.
list
array of object (PaymentModeList)
Payment mode.
Array of PaymentModeList
card_number
string
Nullable
Card number mentioned on the card.
merchant_code
string
Nullable
Unique code identifying the merchant.
card_reference
string
Nullable
Reference identifier for the card.
card_issuer
string
Nullable
Issuing bank or institution of the card.
compliant_with_tokenisation_guidelines
boolean
Nullable
Indicates compliance with tokenization guidelines.
code
string
Nullable
General code for identifying a transaction or status.
cod_limit
number
Nullable
Limit for Cash on Delivery (COD) transactions.
intent_flow
boolean
Nullable
Flow or process intended for the transaction.
fynd_vpa
string
Nullable
Virtual Payment Address (VPA) used by Fynd.
intent_app_error_dict_list
array of object (IntentAppErrorList)
Nullable
List of error dictionaries related to intent app.
Array of IntentAppErrorList
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
aggregator_name
string
Name of the payment aggregator.
card_fingerprint
string
Nullable
Unique fingerprint of the card for identification.
intent_app_error_list
array of string
Nullable
List of errors associated with the intent app.
intent_app
array of object (IntentApp)
Nullable
Application intended for handling the transaction.
Array of IntentApp
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
logos
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
display_name
string
Nullable
Display Name of the intent App.
expired
boolean
Nullable
Indicates whether the card is expired.
retry_count
integer
| int32
Nullable
Number of retry attempts.
exp_year
integer
| int32
Nullable
Card's expiration year.
exp_month
integer
| int32
Nullable
Card's expiration month.
card_id
string
Nullable
Unique identifier for the card saved at aggregators end.
remaining_limit
number
Nullable
Remaining available limit on the card.
display_priority
integer
| int32
Nullable
Priority of display in the user interface.
card_brand
string
Nullable
Brand of the card (e.g., Visa, MasterCard).
cod_limit_per_order
number
Nullable
Maximum limit per order for COD transactions.
logo_url
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
nickname
string
Nullable
User-defined name for the card.
card_name
string
Nullable
Name printed on the card.
card_type
string
Nullable
Type of the card (e.g., debit, credit).
card_brand_image
string
| url
Nullable
Image representing the card brand.
display_name
string
Nullable
Display name for the card in the user interface.
card_isin
string
Nullable
International Securities Identification Number for the card.
timeout
integer
| int32
Nullable
Timeout duration for transactions.
card_token
string
Nullable
Encrypted token representing the card.
name
string
Nullable
User's name.
meta
object
Nullable
Payment methods meta.
partial_payment_allowed
boolean
Indicates if this payment option is eligible for coupling with other payment options, allowing the user to make multi-method of payment (MOP) transactions.
save_card
boolean
Nullable
Card save or not.
aggregator_name
string
Nullable
Display Priority.
name
string
Payment mode name.
anonymous_enable
boolean
Nullable
Anonymous card flag.
payment_flows
object (PaymentFlow)
PaymentFlow
bqr_razorpay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
fynd
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
epaylater
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
razorpay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
juspay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
ajiodhan
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
simpl
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
rupifi
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
mswipe
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
stripe
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
ccavenue
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
payubiz
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
jiopay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
upi_razorpay
object (AggregatorRoute)
AggregatorRoute
data
object
Nullable
Details about aggregator route.
payment_flow_data
object
Nullable
Payment_flow_data.
payment_flow
string
Nullable
Payment_flow.
api_link
string
| url
Nullable
API link of the aggregator.
payment_default_selection
object (PaymentDefaultSelection)
PaymentDefaultSelection
mode
string
Nullable
Default Selection Payment Mode.
identifier
string
Nullable
Identifier for Payment Mode.
skip
boolean
Nullable
Decide if the default payment mode will skip the payment options page altogether or just be preferred on the Frontend.
success
boolean
Response is successful or not.
payment_breakup
object
Payment Breakup for advance payment.
advance_payment
array of object (AdvancePaymentObject)
Nullable
Advance Payment Array.
Array of AdvancePaymentObject
name
string
Nullable
Name of Advance Payment Mode.
display_priority
number
| integer
Nullable
Display Priority for Payment Option.
payment_mode_id
number
| integer
Nullable
Payment Mode ID for Advance Payment Option.
display_name
string
Nullable
Display name for Advance Payment Mode.
list
array of object (PaymentModeList)
Nullable
Payment mode.
Array of PaymentModeList
card_number
string
Nullable
Card number mentioned on the card.
merchant_code
string
Nullable
Unique code identifying the merchant.
card_reference
string
Nullable
Reference identifier for the card.
card_issuer
string
Nullable
Issuing bank or institution of the card.
compliant_with_tokenisation_guidelines
boolean
Nullable
Indicates compliance with tokenization guidelines.
code
string
Nullable
General code for identifying a transaction or status.
cod_limit
number
Nullable
Limit for Cash on Delivery (COD) transactions.
intent_flow
boolean
Nullable
Flow or process intended for the transaction.
fynd_vpa
string
Nullable
Virtual Payment Address (VPA) used by Fynd.
intent_app_error_dict_list
array of object (IntentAppErrorList)
Nullable
List of error dictionaries related to intent app.
Array of IntentAppErrorList
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
aggregator_name
string
Name of the payment aggregator.
card_fingerprint
string
Nullable
Unique fingerprint of the card for identification.
intent_app_error_list
array of string
Nullable
List of errors associated with the intent app.
intent_app
array of object (IntentApp)
Nullable
Application intended for handling the transaction.
Array of IntentApp
code
string
Nullable
Code of the intent App.
package_name
string
Nullable
Package Name of the intent App.
logos
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
display_name
string
Nullable
Display Name of the intent App.
expired
boolean
Nullable
Indicates whether the card is expired.
retry_count
integer
| int32
Nullable
Number of retry attempts.
exp_year
integer
| int32
Nullable
Card's expiration year.
exp_month
integer
| int32
Nullable
Card's expiration month.
card_id
string
Nullable
Unique identifier for the card saved at aggregators end.
remaining_limit
number
Nullable
Remaining available limit on the card.
display_priority
integer
| int32
Nullable
Priority of display in the user interface.
card_brand
string
Nullable
Brand of the card (e.g., Visa, MasterCard).
cod_limit_per_order
number
Nullable
Maximum limit per order for COD transactions.
logo_url
object (PaymentModeLogo)
PaymentModeLogo
large
string
| url
Large Logo.
small
string
| url
Small Logo.
nickname
string
Nullable
User-defined name for the card.
card_name
string
Nullable
Name printed on the card.
card_type
string
Nullable
Type of the card (e.g., debit, credit).
card_brand_image
string
| url
Nullable
Image representing the card brand.
display_name
string
Nullable
Display name for the card in the user interface.
card_isin
string
Nullable
International Securities Identification Number for the card.
timeout
integer
| int32
Nullable
Timeout duration for transactions.
card_token
string
Nullable
Encrypted token representing the card.
name
string
Nullable
User's name.
meta
object
Nullable
Payment methods meta.
partial_payment_allowed
boolean
Indicates if this payment option is eligible for coupling with other payment options, allowing the user to make multi-method of payment (MOP) transactions.
split
object (SplitObject)
Nullable
SplitObject
total_number_of_splits
number
| integer
Nullable
Maximum amount of splits allowed.
splits_remaining
number
| integer
Nullable
Number of splits remaining.
amount_remaining
number
| float
Nullable
Amount pending to be paid.
advance
object (AdvanceObject)
Nullable
AdvanceObject
is_active
boolean
Nullable
Is Advance Payment active.
amount
number
| float
Amount for Payment Breakdown.
time_unit
string
Nullable
Time unit for refunds.
description
string
Nullable
The description for Advance Payment (user configured).
display_name
string
Nullable
The display name for Advance payment.
prepayment_type
string
Nullable
Type of prepayment value.
prepayment_value
number
| float
Nullable
Value for prepayment in advance payment.
cancellation_type
string
Nullable
Type of cancellation.
refund_time_limit
number
| float
Nullable
Time limit for processing refund.
all_prepayment_type
array of string
Nullable
All available types of prepayment.
allow_custom_advance_amount
boolean
Nullable
Is custom advance amount allowed?.
Examples
Parameters
amount:
1000
cart_id:
"2343432412342"
pincode:
"122001"
checkout_mode:
"self"
refresh:
true
card_reference:
"1"
order_type:
"HomeDelivery"
user_details:
"%7B%22first_name%22:%22Fynd%22,%22last_name%22:%22Dummy%22,%22mobile%22:%229999999999%22,%22email%22:%22paymentsdummy@gofynd.com%22%7D"
GET
/service/application/payment/v1.0/payment/options/pos
Loading...
Response
Loading...
POST

Initiate linking of wallet

Link wallet for the aggregator for processing of payment.
Parameters
No Parameters
Request body
aggregator
string
Required
Aggregator Name.
mobile
string
Required
Mobile Number for Wallet.
wallet_code
string
Required
Wallet Code.
Response
200
400
OTP for Wallet Linking sent
WalletResponseSchema
data
object
Response received from aggregator.
success
boolean
Success/Failure of the API call.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/options/wallet/link
Loading...
Response
Loading...
POST

OTP verification

Verify the linking of wallet using OTP for further processing of payment.
Parameters
No Parameters
Request body
aggregator
string
Required
Aggregator Name.
link_token
string
Required
Token for wallet linking.
otp
integer
Required
OTP received for wallet linking.
Response
200
400
OTP Verification
WalletResponseSchema
data
object
Response received from aggregator.
success
boolean
Success/Failure of the API call.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/options/wallet/verify
Loading...
Response
Loading...
POST

Delink the wallet

Delink the wallet.
Parameters
No Parameters
Request body
aggregator
string
Required
Aggregator Name.
wallet_code
string
Required
Wallet Code.
Response
200
400
Wallet delinked successfully
WalletResponseSchema
data
object
Response received from aggregator.
success
boolean
Success/Failure of the API call.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/options/wallet/delink
Loading...
Response
Loading...
POST

Render HTML

Render HTML for a payment aggregator page.
Parameters
No Parameters
Request body
returntype
string
Nullable
Return Type of API.
base64_html
string
Required
Base64 encoded html string.
Response
200
400
Success and return HTML decoded text
RenderHTMLDetails
html
string
HTML string.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/payment/html/render/
Loading...
Response
Loading...
POST

Validate VPA

Validate if a Virtual Payment Address (VPA) is valid for processing payments and returns the validation result.is_valid boolean value indicating whether the VPA is valid for payments.
Parameters
No Parameters
Request body
upi_vpa
string
Required
UPI ID.
aggregator
string
Aggregator slug.
Response
200
400
Success. Returns the status of payment.
ValidateVPADetails
data
object (ValidateUPI)
ValidateUPI
status
string
VALID or INVALID.
customer_name
string
Customer Bank.
is_valid
boolean
Boolean is true or false.
upi_vpa
string
UPI ID.
success
boolean
Response is successful or not.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/validate-vpa
Loading...
Response
Loading...
GET

Credit summary

Get summary of the customer's credit information, including details such as merchant customer reference ID, status, balance, limit, due amount, used amount, due date, days overdue, total due amount, and a repayment URL.
Parameters
aggregator
string
Aggregator name.
Response
200
400
Success. Returns the status of payment. chema` for more details.
CustomerCreditSummaryDetails
data
object (CreditSummary)
CreditSummary
total_due_amount
object (BalanceDetails)
BalanceDetails
formatted_value
string
Nullable
Formatted Amount with currency symbol.
currency
string
Nullable
Currency Code.
value
number
| float
Nullable
Payment amount.
status
string
Nullable
Customer Credit status.
limit
object (BalanceDetails)
BalanceDetails
formatted_value
string
Nullable
Formatted Amount with currency symbol.
currency
string
Nullable
Currency Code.
value
number
| float
Nullable
Payment amount.
credit_line_id
string
Nullable
ID at Credit aggregator end.
amount_available
object (BalanceDetails)
BalanceDetails
formatted_value
string
Nullable
Formatted Amount with currency symbol.
currency
string
Nullable
Currency Code.
value
number
| float
Nullable
Payment amount.
due_amount
object (BalanceDetails)
BalanceDetails
formatted_value
string
Nullable
Formatted Amount with currency symbol.
currency
string
Nullable
Currency Code.
value
number
| float
Nullable
Payment amount.
due_date
string
| date-time
Nullable
Due date for repayment.
balance
object (BalanceDetails)
BalanceDetails
formatted_value
string
Nullable
Formatted Amount with currency symbol.
currency
string
Nullable
Currency Code.
value
number
| float
Nullable
Payment amount.
status_message
string
Nullable
Message to customer.
repayment_url
string
Nullable
Url for repayment.
soa_url
string
Nullable
Statement of accounts. Show payment history.
is_eligible_for_txn
boolean
Nullable
Eligibility flag to complete transaction.
merchant_customer_ref_id
string
Nullable
Unique aggregator customer id.
buyer_status
string
Nullable
Status from Credit aggregator end.
activation_url
string
Nullable
Url for activation.
success
boolean
Payment confirmation updated or not.
Examples
Parameters
aggregator:
"epaylater"
GET
/service/application/payment/v1.0/payment/credit-summary/
Loading...
Response
Loading...
GET

Redirects users to the payment aggregator's interface

This endpoint is used to redirect users to the payment aggregator's platform where they can complete the payment process. The request may include necessary details for initiating the payment on the aggregator’s side, and the user is transferred seamlessly to their interface.
Parameters
source
string
Callback URL to get callback from aggregator.
aggregator
string
Required
Aggregator name.
Response
200
400
Success. Returns the status of payment. chema` for more details.
RedirectToAggregatorDetails
data
object (RedirectURL)
RedirectURL
status
boolean
Aggregator Operation is successful or not.
redirect_url
string
URL to which the user may redirect.
extra
string
extra details, stringify json of the extra data.
success
boolean
Status updated or not.
Examples
Parameters
source:
"https://api.uat.fyndx1.de/service/webhooks/payment/v1.0/callback/"
aggregator:
"epaylater"
GET
/service/application/payment/v1.0/payment/redirect-to-aggregator/
Loading...
Response
Loading...
GET

Verify credit availability and status

Check the availability and status of customer credit, providing the status of payment along with registration information and signup URL if the customer is not registered.
Parameters
aggregator
string
Aggregator name.
Response
200
400
Success. Returns the status of payment.
CheckCreditDetails
data
object (CreditDetail)
CreditDetail
status
boolean
Operation is successful or not.
is_registered
boolean
User is registered with aggregator or not.
signup_url
string
URL to which the user may redirect.
available_credit
number
| float
Available credit balance
success
boolean
Operation is successful or not.
Examples
Parameters
aggregator:
"epaylater"
GET
/service/application/payment/v1.0/check-credits/
Loading...
Response
Loading...
POST

Onboard customer for payment

Initiate the onboarding process for payment services, providing personal, business, and device information, along with marketplace details, to enable customer registration and credit availability.
Parameters
No Parameters
Request body
personal_info
object (UserPersonalInfoInDetails)
UserPersonalInfoInDetails
first_name
string
Required
First name of the individual.
voter_id
string
Nullable
Voter ID number.
gender
string
Nullable
Gender of the individual.
dob
string
Required
Date of birth of the individual.
passport
string
Nullable
Passport number.
fathers_name
string
Nullable
Father's name.
mothers_name
string
Nullable
Mother's name.
middle_name
string
Nullable
Middle name of the individual.
last_name
string
Nullable
Last name of the individual.
pan
string
Nullable
Permanent Account Number (PAN).
driving_license
string
Nullable
Driving license number.
email_verified
boolean
Required
Indicates whether the email is verified.
address_as_per_id
object (KYCAddress)
Required
KYCAddress
city
string
Required
City of the KYC address.
addressline2
string
Nullable
Second line of the address.
state
string
Required
State of the KYC address.
ownership_type
string
Nullable
Type of ownership for the address (e.g., rented, owned).
pincode
string
Required
Postal code of the address.
land_mark
string
Nullable
Landmark near the address.
addressline1
string
Required
First line of the address.
mobile_verified
boolean
Required
Indicates whether the mobile number is verified.
phone
string
Required
Phone number.
email
string
Nullable
Email address.
mcc
string
Nullable
Merchant Category Code, indicating the type of business.
aggregator
string
Required
Payment aggregator handling the transaction.
marketplace_info
object (MarketplaceInfo)
MarketplaceInfo
date_of_joining
string
Nullable
Date of joining.
name
string
Required
Name of store.
membership_id
string
Required
Merchant id.
source
string
| url
Required
Callback url.
business_info
object (BusinessDetails)
BusinessDetails
business_ownership_type
string
Nullable
Type of business ownership (e.g., sole proprietorship, partnership).
vintage
string
Nullable
Age or duration of the business.
gstin
string
Nullable
Goods and Services Tax Identification Number.
pan
string
Nullable
Permanent Account Number of the business.
entity_type
string
Nullable
Type of legal entity (e.g., corporation, LLC).
shop_and_establishment
object
Shop and Establishment registration details.
fssai
string
Nullable
Food Safety and Standards Authority of India registration number.
fda
string
Nullable
Food and Drug Administration registration number.
business_type
string
Nullable
Type of business (e.g., retail, wholesale).
name
string
Nullable
Name of the business.
address
object (KYCAddress)
KYCAddress
city
string
Required
City of the KYC address.
addressline2
string
Nullable
Second line of the address.
state
string
Required
State of the KYC address.
ownership_type
string
Nullable
Type of ownership for the address (e.g., rented, owned).
pincode
string
Required
Postal code of the address.
land_mark
string
Nullable
Landmark near the address.
addressline1
string
Required
First line of the address.
device
object (DeviceDetails)
DeviceDetails
identification_number
string
Nullable
IP.
identifier_type
string
Nullable
Static value = ip.
device_model
string
Nullable
Device Model.
device_make
string
Nullable
Device maker.
device_type
string
Nullable
Device Type(E.g. Mobile).
os
string
Nullable
OS Name.
os_version
string
Nullable
OS Version.
Response
200
400
Success. Returns the status of payment.
CustomerOnboardingDetails
data
object (OnboardSummary)
OnboardSummary
redirect_url
string
URL to which the user may redirect.
session
object
User Session.
status
boolean
Transaction status.
status_remark
string
Description of status.
is_eligible_for_txn
boolean
Whether is eligible for transaction.
merchant_customer_ref_id
string
Rupifi customer ID.
activation_url
string
Url for activation.
success
boolean
Status updated or not.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/credit-onboard/
Loading...
Response
Loading...

Refund

Refund is the process of reimbursing a customer for a previous purchase. This typically involves returning the money to the customer's bank account, walllet, UPI or any other payment methods in which customer wants refund after they have returned the purchased item or requested a reimbursement for a service. A bank account for refund with IFSC code verification and secure OTP-based addition is a feature that allows customers to securely add their bank account details for receiving refunds. This functionality includes verification of the bank account details, such as the IFSC code, to ensure accuracy and validity. Additionally, it employs an OTP (One-Time Password) authentication process to securely add the bank account information, enhancing the security of the refund process and protecting customer financial data.

Operations
GET
/service/application/payment/v1.0/refund/order/beneficiaries
# Retrieve beneficiary details
POST
/service/application/payment/v1.0/refund/verification/bank
# Verify OTP for bank and add beneficiary
POST
/service/application/payment/v1.0/refund/account
# Add beneficiary for refund
POST
/service/application/payment/v1.0/refund/account/otp
# Add refund account using OTP verification
POST
/service/application/payment/v1.0/refund/verification/wallet
# Verify OTP for wallet
POST
/service/application/payment/v1.0/refund/beneficiary/default
# Set default beneficiary for refund
GET

Retrieve beneficiary details

Get beneficiary details like bank name , ifsc code , branch name associated with a specific order for refund processing.
Parameters
order_id
string
Required
A unique number used for identifying and tracking your orders.
Response
200
400
Success. Returns the details of the beneficiary getting a refund.
OrderBeneficiaryFetchDetails
show_beneficiary_details
boolean
Show beneficiary details or not.
beneficiaries
array of object (OrderBeneficiaryDetails)
Nullable
All Beneficiaries Of An Order.
Array of OrderBeneficiaryDetails
modified_on
string
| date-time
Modification Date of Beneficiary.
account_no
string
Account Number.
mobile
string
Mobile no of User.
bank_name
string
Bank Name Of Account.
ifsc_code
string
Ifsc Code Of Account.
is_active
boolean
Boolean Flag whether Beneficiary is active or not.
beneficiary_id
string
Beneficiary Id.
account_holder
string
Account Holder Name.
email
string
EMail of User.
delights_user_name
string
Nullable
User Id Who filled the Beneficiary.
id
integer
| int32
Id of the Order Beneficiary.
transfer_mode
string
Transfer Mode Of Account.
branch_name
string
Branch Name Of Account.
created_on
string
| date-time
Creation Date of Beneficiary.
subtitle
string
SHort Title Of Account.
comment
string
Remarks.
address
string
Address of User.
title
string
Title Of Account.
display_name
string
Display Name Of Account.
Examples
Parameters
order_id:
"FY65C2797B2F00FCF07E"
GET
/service/application/payment/v1.0/refund/order/beneficiaries
Loading...
Response
Loading...
POST

Verify OTP for bank and add beneficiary

Verify the OTP provided by the user and adds a bank beneficiary for refund processing.
Parameters
No Parameters
Request body
request_id
string
Required
Request id.
hash_key
string
Required
Hash key of the beneficiary Id.
otp
string
Required
Otp sent to the given Mobile No.
Response
200
400
Success.
AddBeneficiaryViaOtpVerificationDetails
success
boolean
Response is successful or not.
message
string
Aggregator Response of beneficiary.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/refund/verification/bank
Loading...
Response
Loading...
POST

Add beneficiary for refund

Add beneficiary details specifically for refund transactions, including account holder name, account number and bank details.
Parameters
No Parameters
Request body
delights
boolean
Required
True if beneficiary to be added by delights or False if by User.
shipment_id
string
Required
Shipment Id of the respective Merchant Order Id.
details
object (BeneficiaryModeDetails)
Required
BeneficiaryModeDetails
account_no
string
Required
Account Number of the Account Holder.
address
string
Address of the User.
mobile
string
Required
Mobile Number of the User.
bank_name
string
Required
Bank Name of the Account.
comment
string
Remarks added by The user.
ifsc_code
string
Required
Ifsc Code of the Account.
vpa
string
Nullable
VPA of the Account.
branch_name
string
Required
Branch Name of the Account.
account_holder
string
Required
Name of the Account Holder.
wallet
string
Nullable
Wallet of the Account.
email
string
Required
Email of the Account Holder.
otp
string
OTP received by customer.
order_id
string
Required
Merchant Order Id.
transfer_mode
string
Required
Transfer Mode of the Beneficiary to be added.
request_id
string
Request Id for add benificiary request.
Response
200
400
Success. Shows whether the beneficiary details were saved to a returned/cancelled order or not.
RefundAccountDetails
is_verified_flag
boolean
Flag for verification of refund.
data
object
Refund account data.
success
boolean
Success or failure flag.
message
string
Response message.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/refund/account
Loading...
Response
Loading...
POST

Add refund account using OTP verification

Add bank account specifically for refunds, employing OTP verification for security.
Parameters
No Parameters
Request body
order_id
string
Required
Unique identifier for an order.
details
object (BankDetailsForOTP)
Required
BankDetailsForOTP
account_no
string
Required
Account number of the holder.
bank_name
string
Required
Name of the bank.
ifsc_code
string
Required
IFSC code of the bank.
branch_name
string
Required
Branch name of the bank.
account_holder
string
Required
Name of the account holder.
Response
200
400
Success. Shows whether the beneficiary details were saved to a returned/cancelled order or not.
RefundAccountDetails
is_verified_flag
boolean
Flag for verification of refund.
data
object
Refund account data.
success
boolean
Success or failure flag.
message
string
Response message.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/refund/account/otp
Loading...
Response
Loading...
POST

Verify OTP for wallet

Verify OTP provided by the user and adds a wallet beneficiary.
Parameters
No Parameters
Request body
country_code
string
Required
Country Code of the Mobile Number.
mobile
string
Required
Wallet Mobile Number of the User.
Response
200
400
Success. Sends the OTP to the given mobile number.
WalletOtpDetails
request_id
string
Request Id for wallet otp request.
is_verified_flag
string
Boolean Flag whether OTP Validation is already done or not.
success
boolean
Response is successful or not.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/refund/verification/wallet
Loading...
Response
Loading...
POST

Set default beneficiary for refund

Update default beneficiary for the order refund of the user.
Parameters
No Parameters
Request body
order_id
string
Required
Merchant Order Id.
beneficiary_id
string
Required
Beneficiary Hash Id of the beneficiary added.
shipment_id
string
Shipment Id of the order.
Response
200
400
Success.
SetDefaultBeneficiaryDetails
is_beneficiary_set
boolean
Boolean Flag whether Beneficiary set or not.
success
boolean
Response is successful or not.
Examples
Parameters
body:
body
POST
/service/application/payment/v1.0/refund/beneficiary/default
Loading...
Response
Loading...

Refund Transfer Modes

Refund transfer modes encompass various methods for processing refunds to customers, such as issuing store credit or vouchers for future purchases and providing refunds via digital payment platforms like Paytm or PhonePe.

Operations
GET
/service/application/payment/v1.0/refund/transfer-mode
# Get refund transfer modes
PUT
/service/application/payment/v1.0/refund/transfer-mode
# Toggle refund mode
GET

Get refund transfer modes

Lists available refund modes, such as UPI, providing details like display name, logo, and ID for each mode.
Parameters
No Parameters
Response
200
Success. Shows the available refund mode to choose, e.g. Netbanking.
TransferModeFetchDetails
data
array of object (TransferModeDetails)
Response Object.
Array of TransferModeDetails
items
array of object (TransferItemsDetails)
Beneficiary Mode Items.
Array of TransferItemsDetails
id
integer
| int32
Id of the transfer item.
display_name
string
Beneficiary Display Name.
logo_large
string
Beneficiary large Logo.
logo_small
string
Beneficiary small Logo.
name
string
Beneficiary Name.
display_name
string
Beneficiary Mode Name.
Examples
Parameters
Parameters are not required.
GET
/service/application/payment/v1.0/refund/transfer-mode
Loading...
Response
Loading...
PUT

Toggle refund mode

Enable/Disable a particular refund transfer mode based on the request body parameters, indicating whether the mode should be enabled or disabled.
Parameters
No Parameters
Request body
enable
boolean
Required
True for enabling the Transfer Mode.
transfer_mode
string
Required
Transfer Mode of the Beneficiary to be added.
Response
200
Success. Shows whether the refund mode was successfully enabled or disabled.
RefundTransferModeUpdateDetails
success
boolean
Response is successful or not.
Examples
Parameters
body:
body
PUT
/service/application/payment/v1.0/refund/transfer-mode
Loading...
Response
Loading...