Card

Customers can make payments with their credit and debit cards. The API returns a payment link that the customer can use to securely enter their card details and complete the transaction.

To create a card collection, Initiate a collection request with at least one payment method:

curl --request POST \
     --url https://api.gravv.xyz/v1/collections \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: order_789_attempt_1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": "50",
  "currency": "USD",
  "country": "NG",
  "customer_id": "04dfb2e5-1274-4214-b5fd-3415fde7dc17",
  "client_customer_id": "checkers_user",
  "client_reference": "9d8184a1-4a19-b74d-4797-9896aed01332",
  "source": {
    "source_type": "external",
    "methods": [
      "card"
    ]
  },
  "destination": {
    "id": "bccb74d8-9715-478d-bcac-9d8184a19530",
    "destination_type": "internal_crypto_wallet"
  }
}
'

You will receive a response similar to this:

{
  "data": {
    "amount": "50",
    "client_reference": "trasdfausdaa",
    "country": "KE",
    "currency": "USD",
    "onramp_status": "initialized",
    "payment_link": "https://pay-staging.gravv.xyz?transaction_id=07b655cc-3dbd-4f6c-a16c-4657946d2e08",
    "raw_payment_link": "https://sandbox.coinflow.cash/polygon/purchase...",
    "transaction_id": "07b655cc-3dbd-4f6c-a16c-4657946d2e08",
    "transaction_status": "pending"
  },
  "error": null
}