Deposits

Deposits

To initiate a deposit payment request, you should use the initiateHostedPayment mutation.

initiateDeposit

mutation {
    initiateHostedPayment(
        paymentType: deposit,
        amount: 100,
        currency: usd,
        countryCode: "NG",
        reference: "test_ref_1",
        metadata: { customer_id: "2e7d57e2-a10e-4420-9d05-e109627a157a" },
        redirectUrl: "https://useaccrue.com",
        firstName: "Clinton",
        lastName: "Mbah",
        email: "[e-mail]"
    ) {
        id
        hostedLink
        status
    }
}
        

• paymentType: deposit

• amount: The amount you want to charge your customer

• currency: The currency you want to charge the amount in. It can be either usd or local_currency. The local currency to be charged is determined by the country

• country: The two-letter ISO code of the country your customer is resident in. We can charge them in the country's local currency

• reference (optional): Your unique reference

• metadata (optional): Your arbitrary JSON metadata for this transaction. This metadata is included in the payload of webhook events for this transaction

• redirectUrl (optional): The URL you want us to redirect your customer to after the transaction is completed

• firstName: Your customer's first name

• lastName: Your customer's last name

• email: Your customer's email

Response

Returns a merchant payment request.

• id: The ID of the payment request

• hostedLink: A link to the hosted payment page you should redirect your customer to

• status: The current status of the payment request

  • created: The initial state of your payment request upon creation.

  • picked_up: Your customer has chosen an agent to deposit through.

  • completed: The payment request has been successfully completed. If it's a deposit, your balance will get credited. If it's a withdrawal, your balance will be debited.

  • canceled: The payment request was canceled. Either by the user or by dispute resolution.