Version: 1.0.0
Using Bitmuk API you can Receive Payment in any currency from you customers.
To use this API, you need an API KEY.Please create account or login into the Bitmuk to get your owl API KEY from profile section.
#API Endpoint
http://bitmuk.com/payment/connection
To get payment connection you need to make a POST call to the following url :
http://bitmuk.com/payment/connection
Sandbox API Credentials :
Email: sandbox@test.com
Verification Code: 11223
Field | Description |
---|---|
Accept | application/json |
x-api-key | IvHcUZARLSHOJrt2EA7W8NcQAKwcHfGrGWkDyr2HY2wOwP5HUGlV8Wj9lJUc |
Field | Type | Description |
---|---|---|
ref_code | String | The referral code will be used to identify your customer payment |
amount | decimal | Your user payment amount |
currency | String | Currency must be uppercase. like: USD,RUB,INR |
ipn_url | string | Webhooks payment url instant payment notification |
success_url | String | This url redirect when user payment successfully |
cancel_url | String | This url redirect when user payment failed or cancel |
customer_email | string | Your customer email address |
#Here is a curl example
$parameters = [
'ref_code' => 'DFU80XZIKS',
'currency' => 'USD',
'amount' => 50.00,
'ipn_url' => 'https://webhook.site/49a36acb-dd05-4502-9c2c-72d4cc390f29',
'cancel_url' => 'http://example.com/cancel_url.php',
'success_url' => 'http://example.com/success_url.php',
'customer_email' => 'john@mail.com',
];
$headers = [
'Accept: application/json',
'x-api-key: IvHcUZARLSHOJrt2EA7W8NcQAKwcHfGrGWkDyr2HY2wOwP5HUGlV8Wj9lJUc',
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_URL, 'http://bitmuk.com/payment/connection');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($parameters));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
print_r($response);
#Success Response :
{
"success": true,
"message": "Redirect to url for payment connection.",
"redirect_url": "http://bitmuk.com/payment/checkout?payment_id=xnbWryya1quM3caFWW8
GCxGdHfAdowXhLqOTPYFzDjj55f72wshSHefIUvCi32AELH04w
kcEHRsi1axeYcbUujd0M97z8jfopRnf"
}
#Invalid API Response :
{
"message": "Unauthenticated."
}
This url use instant payment notification for your user
#IPN functionality
$signature = $request->header('signature');
$yourSignature = hash_hmac('sha256', 'ref_code', 'Your Api secret Key');
if ($_POST['status'] == 'success' && $signature == $yourSignature){
// your user payment done. your logic apply this section
}