Card Payments

Here are the APIs to process card transactions through Sendsprint’s payment gateway.

Sample test cards to use are:

• 4242424242424242

• 4273149019799094

• 4659105569051157

Charge

This endpoint is used to initiate a card payment transaction.

URL

{baseUrl}/developer/chargecard

REQUEST BODY SAMPLE

{
  "source": {
    "type": "string",
    "number": "string",
    "expiry_month": 0,
    "expiry_year": 0,
    "cvv": "string"
  },
  "amount": 0,
  "currency": "string",
  "reference": "string"
}

REQUEST

curl --location --request POST 
'{baseUrl}/developer/upload/entity' \
--header 'Content-Type: application/json' \
--header 'Authorization: bearer_token' \
--data '{
  "source": {
    "type": "card",
    "number": "4242424242424242",
    "expiry_month": 12,
    "expiry_year": 2024
  },
  "amount": 6500,
  "currency": "USD",
  "reference": "ORD-5023-4E89"
}'

SUCCESS RESPONSE

{
    "ResponseCode": "00",
    "ResponseMessage": "Successful",
    "Data": {
        "id": "pay_vtqbaonvropepplubu5yztv234",
        "action_id": "act_rgw53k7vthgupgrvq5lox3wfsu",
        "amount": 6500,
        "currency": "USD",
        "approved": true,
        "status": "Authorized",
        "auth_code": "493601",
        "response_code": "10000",
        "response_summary": "Approved",
        "balances": {
            "total_authorized": 6500,
            "total_voided": 0,
            "available_to_void": 6500,
            "total_captured": 0,
            "available_to_capture": 6500,
            "total_refunded": 0,
            "available_to_refund": 0
        },
        "risk": {
            "flagged": false,
            "score": 0.0
        },
        "source": {
            "id": "src_4wducr5cgo4etm5urbq2ii5jn4",
            "type": "card",
            "expiry_month": 12,
            "expiry_year": 2024,
            "scheme": "Visa",
            "last4": "4242",
            "fingerprint": "ABD67B80FE37E0CED4E14BED93A96CB07C070369F6CAFB595F5A47BB29060CAB",
            "bin": "424242",
            "card_type": "CREDIT",
            "card_category": "CONSUMER",
            "issuer": "STRIPE PAYMENTS UK LIMITED",
            "issuer_country": "GB",
            "product_id": "F",
            "product_type": "Visa Classic",
            "avs_check": "G",
            "payment_account_reference": "V001960568281014580"
        },
        "processed_on": "2024-04-04T10:51:36.8062161Z",
        "reference": "ORD-5023-4E89",
        "scheme_id": "861909800329455",
        "processing": {
            "acquirer_transaction_id": "986046969246770924619",
            "retrieval_reference_number": "519928250447",
            "merchant_category_code": "5815",
            "scheme_merchant_id": "528814",
            "scheme": "VISA",
            "aft": false,
            "pan_type_processed": "fpan",
            "cko_network_token_available": false
        },
        "expires_on": "2024-05-04T10:51:36.8062161Z",
        "_links": {
            "self": {
                "href": "https://api.example.com/payments/pay_vtqbaonvropepplubu5yztv234"
            },
            "actions": {
                "href": "https://api.example.com/payments/pay_vtqbaonvropepplubu5yztv234/actions"
            },
            "capture": {
                "href": "https://api.example.com/payments/pay_vtqbaonvropepplubu5yztv234/captures"
            },
            "void": {
                "href": "https://api.example.com/payments/pay_vtqbaonvropepplubu5yztv234/voids"
            }
        }
    }
}

FAILED RESPONSE

{
    "ResponseCode": "03",
    "ResponseMessage": "Unable to process",
    "Data": {
        "request_id": "aa8b56ce-b23e-4a58-a954-7bbafbcf57ae",
        "error_type": "processing_error",
        "error_codes": [
            "card_expired"
        ]
    }
}

Note: The Data field will always contain the actual reason for the failure