Dinar Dragon API

API URL for Step 2	HTTP Method
https://dinardragon.com/execute	POST

STEP 2: Use the authentication code you got from Step 1 to finalize the payout. Pass the following data to the /execute POST endpoint:

EXPECTED FIELDS TO FINALIZE PAYOUT:

authcode (string)
Authentication code you obtained from Step 1

You will also need to provide an Authorization value in the header of your HTTP request. You provide your private key here.

Once you pass the authentication code to the /execute POST endpoint, the payout is complete. Your recipients will receive the funds directly in their bank account within 15 minutes. You can cancel the payment before hitting the /execute endpoint by letting your authentication code expire. That will take 15 minutes.

Once you hit the /execute endpoint within 15 minutes of generating the authentication code, the payout is finalized. This finalization in Step 2 is irreversible.

Here is an example of how to structure your HTTP body for this request:

Example - JSON Request Body For /execute endpoint

                
                    {
                        "authcode": "6afc61f8c5e7738819b7021dc0664cab" //unique authentication code
                    }

Here are the expected JSON responses:

SUCCESS:

HTTP RESPONSE:

code (integer)	accounts (array of objects)	charge_in_usd (float)	payment_id (string)	message (string)
HTTP Response Code, e.g. 200, 201	Array of objects containing details of each payment in the payout you have just finalized	Amount in USD Dinar Dragon will charge your dashboard balance to make this payout	ID of entire payout	Confirmation message of payout completion

CONTENTS OF EACH OBJECT IN ACCOUNTS (ARRAY OF OBJECTS):

accNo (integer)	amount (float)	bank (string)	country (string)	recipientname (string)	date (string)	time (string)	email (string)	uniqueid (string)
Account number of recipient bank account	Amount in USD to pay recipient bank account	Name of bank of recipient	Recipient country	Recipient name	Date of payment	Time of payment	Email address of account that made this payment	ID of individual payment

FAIL:

code (integer)	error (string)
HTTP Response Code, e.g. 403, 400	Error message that tells you why the request failed

Here are some examples of the format of the HTTP responses to expect:

JSON Response - Success

                
                    {
                        "code": 200,
                        "accounts": [
                            {
                                "amount": 50,
                                "bank": "somebank",
                                "country": "US",
                                "recipientname": "somename",
                                "accNo": 123456789,
                                "date": "2025-01-31",
                                "time": "14:35",
                                "email": "youremail@anemailprovider.com", //the email address linked to your account
                                "uniqueid": "df9a31ea528a3977",  //save uniqueid in your database to use later to check payment status
                            },
                            {
                                "amount": 70,
                                "bank": "someotherbank",
                                "country": "SA",
                                "recipientname": "someothername",
                                "accNo": 987654321,
                                "date": "2025-01-31",
                                "time": "14:35",
                                "email": "youremail@anemailprovider.com", //the email address linked to your account
                                "uniqueid": "adec957cc3860ec6",  //save uniqueid in your database to use later to check payment status
                            },
                            {
                                "amount": 75,
                                "bank": "yetanotherbank",
                                "country": "US",
                                "recipientname": "yetanothername",
                                "accNo": 111111111,
                                "date": "2025-01-31",
                                "time": "14:35",
                                "email": "youremail@anemailprovider.com", //the email address linked to your account
                                "uniqueid": "dd6b346e7d0ef747", //save uniqueid in your database to use later to check payment status
                            }
                        ],
                        "charge_in_usd": 4.875,
                        "payment_id": "1617fcccd1f3269c", //save payment_id in your database to use later to check payment status
                        "message": "Payout successfully processed. The funds will be disbursed to the bank account(s) within 15 minutes."
                    }

JSON Response - Fail

                
                    {
                        "code": 400, //Fail
                        "error": "Your request failed because your authcode is invalid or has expired. Retry this payout with a new authcode.",
                    }

Here are some code examples you can copy and paste:

Step 2 - Execute Payout Using Authentication Code From Step 1


            // Example JavaScript to call /execute API endpoint
            async function executePayout(authcode) {
                const data = {
                    authcode: authcode,  // Authentication code from previous step
                    publickey: 'yourPublicKey',
                    privatekey: 'yourPrivateKey'
                };

                try {
                    const response = await fetch('https://dinardragon.com/execute', {
                        method: 'POST',
                        headers: {
                            'Content-Type': 'application/json'
                        },
                        body: JSON.stringify(data)
                    });

                    const result = await response.json();

                    if (result.code === 200) {
                        console.log('Payout executed successfully!');
                    } else {
                        console.error('Error:', result.error);
                    }
                } catch (error) {
                    console.error('Error:', error);
                }
            }

            // Assuming authcode is retrieved from Step 1
            const authcode = 'yourAuthenticationCode';
            executePayout(authcode);  // Execute payout with the authcode

That's it! You're done. The payout is complete and your users will receive their funds within 15 minutes. You will also be able to see the payout on your dashboard.

Dinar Dragon API Documentation