Additional Setup

This section Get's transaction detail and transaction list.

List of additional fields setup:

To get the Transaction Details

For Transaction Details, use the below Get request to get the transaction details.

GET API LINK: https://api.foloosi.com/v1/api/transaction-detail/YOUR_TRANSACTION_ID

HEADERS:
secret_key : YOUR_SECRET_KEY

SAMPLE RESPONSE ON API v1:
{
    "message": "Transaction detail are",
    "data": {
        "transaction_no": "FLSXXXXXXXXXXXXXX",
        "payment_transaction_id": "1234567-819201112",
        "receipt": null,
        "request_currency": "AED",
        "request_amount": 18,
        "customer_currency": "AED",
        "customer_amount": 18,
        "merchant_currency": null,
        "merchant_amount": null,
        "status": "pending",
        "created": "2022-11-01T10:21:04+00:00",
        "optional1": "order-id-123",\\optional fields passed on initialize api
        "optional2": "order-reference",\\optional fields passed on initialize api
        "optional3": "",\\optional fields passed on initialize api
        "subscription_no": ""
    }
}

Note

If you want to fetch customer detail and customer card details along with transaction details Api, change the above API from v1 to v2.

GET API LINK: https://api.foloosi.com/v2/api/transaction-detail/YOUR_TRANSACTION_ID

HEADERS:
secret_key : YOUR_SECRET_KEY

SAMPLE RESPONSE ON API v2
{
    "message": "Transaction detail are",
    "data": {
        "transaction_no": "FLSXXXXXXXXXXXXXX",
        "receipt": null,
        "request_currency": "AED",
        "request_amount": 18,
        "customer_currency": "AED",
        "customer_amount": 18,
        "merchant_currency": "AED",
        "merchant_amount": 18,
        "status": "pending",
        "payment_failed_reason": null,
        "created": "2022-11-01T10:21:04+00:00",
        "optional1": "1757",\\optional fields passed on initialize api
        "optional2": "https://woo.foloosi.in",\\optional fields passed on initialize api
        "optional3": "",\\optional fields passed on initialize api
        "subscription_no": "",
        "customer": {
            "name": "FOLOOSI",
            "email": "[email protected]",
            "phone_number": "+971531234234"
        },
        "card": {
            "pan": "54321******1234",
            "card_type": "CREDIT",
            "bin_card": "MASTERCARD",
            "issuer_name": "MASTERCARD",
            "issuer_country": "UNITED STATES",
            "card_expiry": "2212",
            "holder_name": "FOLOOSI",
            "card_reference": "",
            "card_id": 123456,
            "card_bin": "12345",
            "bin_bank": "MASTERCARD - MEMBER TEST FACILITY",
            "bin_type": "CREDIT",
            "bin_level": "MIXED BIN",
            "bin_country_code": "US",
            "bin_website": "https://www.mastercard.us",
            "bin_phone": "1-800-307-7309",
            "bin_valid": true,
            "card_issuer": "MASTERCARD"
        }
    }
}

To get the Transaction List

For Transaction List details, use the below Get request to get the transaction specific to merchant key.

  GET API LINK:
  https://api.foloosi.com/v1/api/transaction-list

  HEADERS:
  secret_key : YOUR_SECRET_KEY
  
  SAMPLE RESPONSE:
  {
    "message": "Merchant sales report are",
    "data": {
        "transactions": [
            {
                "transaction_no": "FLSXXXXXXXXXXXXXXX1",
                "send_amount": 1.35,
                "sender_currency": "AED",
                "tip_amount": 0,
                "receive_currency": "AED",
                "special_offer_applied": "No",
                "sender_amount": 1.35,
                "receive_amount": 1.35,
                "offer_amount": 0,
                "vat_amount": 0.05,
                "foloosi_fee": 0.04,
                "transaction_fixed_fee": 1,
                "customer_foloosi_fee": 0,
                "status": "success",
                "created": "2022-10-18T07:52:38+00:00",
                "sender": {
                    "name": "Foloosi",
                    "email": "[email protected]",
                    "business_name": null,
                    "phone_number": "9870162534"
                }
            },
            {
                "transaction_no": "FLSXXXXXXXXXXXXXXXX2",
                "send_amount": 385.66,
                "sender_currency": "AED",
                "tip_amount": 0,
                "receive_currency": "AED",
                "special_offer_applied": "No",
                "sender_amount": 385.66,
                "receive_amount": 385.66,
                "offer_amount": 0,
                "vat_amount": 0.69,
                "foloosi_fee": 12.73,
                "transaction_fixed_fee": 1,
                "customer_foloosi_fee": 0,
                "status": "success",
                "created": "2022-10-18T07:35:41+00:00",
                "sender": {
                    "name": "foloosi tech",
                    "email": "[email protected]",
                    "business_name": null,
                    "phone_number": "987654321"
                }
            }
    ]}
}

Skip Customer signup

This section shows you how to skip signup page on payment screen.

Steps to be followed :

  • Add post customer details in initialize api to skip this following page.

  • If you pass amount and currency data alone, You will be navigated to the signup page for getting customer details as shown below.

  • If you pass customer details in initialize Api, it will skip the page above and navigate to Payment Screen directly as shown below.

Support

Visit https://www.foloosi.com for support requests or email to [email protected].

Developed by

Foloosi Technologies Pvt Ltd.

License

Copyrights (c) 2024 Foloosi

Last updated