LocalRamp API Documentation
  • Introduction
  • Getting Started
  • Crypto On-ramp
    • Overview
    • Widget Pop-up
    • Full-page checkout
    • Get Limits
    • Get Supported currencies
    • Get Quote
    • List Payment Methods
    • Get Transaction State
  • CRYPTO OFF-RAMP
    • Overview
    • Direct API Sell
      • Instant Sell
      • Get Transaction State
      • Get Limits
      • Get Supported Currencies
      • Get Supported Payment Methods
      • Get Supported Banks
      • Get Crypto Balance
      • Get Rates
      • Verify Bank Account
    • Widget Sell
      • Full-page checkout
      • Widget Pop-up
      • Get Limits
      • Get Quote
      • Get Supported currencies
      • Get Supported Payment Methods
      • Get Transaction State
  • PAYMENTS ON-RAMP
    • Overview
    • Full-page checkout
    • Widget Pop-up
    • White-Label API (Direct Charge)
    • Rates and Fees
    • Get Limits
    • Get Supported Currencies
    • Get Supported Payment Method
    • Withdraw crypto
    • Verify crypto withdrawal
    • Verify transaction
    • Get USDT balance
    • KYC
      • BVN Verification
      • Send OTP
  • Institutional Onramp (>$100k)
    • Overview
    • Initiate transaction
    • Complete transaction
    • Fetch transation
    • Exchange Rate
  • CRYPTO SWAPS
    • Overview
    • Instant Swap
    • Get Transaction State
    • Get Limits
    • Get Supported Currencies
    • Get Rates
  • Webhooks
    • Introduction
    • Verification
    • Events
  • TEST INTEGRATION
    • Simulate Webhooks
      • Fiat received (onramp)
      • Crypto Sent (onramp)
      • Sell completed (offramp)
      • Swap completed
    • Demo transaction
      • Example Completed Buy
      • Example Completed Sell (Bank Account)
      • Example Completed Sell (Mobile Money)
      • Example Completed Swap
Powered by GitBook
On this page
  1. CRYPTO OFF-RAMP
  2. Direct API Sell

Get Transaction State

After initiating an instant sell, you should fetch the transaction to know the current status. Make a GET request to either of the following endpoints using your tx_ext_reference OR localramp's reference.

https://api.localramp.co/v1/transaction/sell/status/:ext_reference/ext

OR

https://api.localramp.co/v1/transaction/sell/status/:reference

With the following header

x-auth-token: <SECRET_KEY>

If the API call is successful, LocalRamp returns the following response:

{
    "status": "success",
    "data": {
        "reference": "our-unique-ref",
        "tx_ext_reference": "your-unique-ref",
        "status": "completed",
        "destination_type": "bank_account",
        "account_number": "0123456789",
        "bank_code": "000",
        "account_name": "RAJI JOHNSON",
        "bank_name": "UNITED BANK",
        "from_amount": "0.038058405",
        "from_currency": "BTC",
        "to_amount": "127890",
        "to_currency": "NGN",
        "phone_number":"+12345677",
        "phone_network": "mobile_money_mtn"
    }
}

The possible status's are pending , completedand failed

pending - This means we are still processing the sell transaction

completed - This means that the transaction has been completed

PreviousInstant SellNextGet Limits

Last updated 9 months ago