AKakahu
Payments

Make a payment

Changed on

Initiate a payment from the user's connected bank account to another New Zealand bank account.

The payee bank account is not required to be connected to Akahu.

For more details about payments see:

  • 📚 Making a payment guide
  • 📚 Payment lifecycle guide
  • 📖 Payment webhooks
post/payments

Request

  • Base URL
    https://api.akahu.io/v1
  • URL
    https://api.akahu.io/v1/payments
  • Auth
    HTTP bearer

Headers

X-Akahu-Idstring required

Your App ID Token.

Content-Typestring

Request body

fromstring required

The Akahu Account ID you want to pay from

amountnumber required

The payment amount

Example request

{
  "from": "acc_1111111111111111111111111",
  "to": {
    "name": "Sammy Sample",
    "account_number": "01-2345-6789012-00"
  },
  "amount": 9.5,
  "meta": {
    "source": {
      "code": "code",
      "reference": "reference"
    },
    "destination": {
      "code": "code",
      "reference": "reference"
    }
  }
}

Response

Successful response.

successboolean
item_idstring

⚠️ Deprecated The Akahu Payment ID replaced via item._id

statusstring

⚠️ Deprecated The Akahu Payment status replaced via item.status

Example response

{
  "item": {
    "_id": "payment_1111111111111111111111111",
    "from": "acc_1111111111111111111111111",
    "to": {
      "account_number": "12-1234-1234567-12",
      "name": "John Smith"
    },
    "amount": 9.51,
    "meta": {
      "destination": {
        "particulars": "destPart",
        "code": "destCode",
        "reference": "destRef"
      },
      "source": {
        "code": "sourceCode",
        "reference": "sourceRef"
      }
    },
    "sid": "akp111111111",
    "status": "READY",
    "status_text": "This payment has just been created and is ready to be sent",
    "timeline": [
      {
        "status": "READY",
        "time": "2020-01-01T01:00:00.000Z",
        "eta": "2020-01-01T01:00:00.000Z"
      }
    ],
    "created_at": "2020-01-01T01:00:00.000Z",
    "updated_at": "2020-01-01T01:00:00.000Z",
    "received_at": "2020-01-01T01:00:00.000Z"
  },
  "item_id": "payment_1111111111111111111111111",
  "status": "READY"
}

Changes

  • 52ef70f3df76Revision changes
    • info

      removed the PENDING_APPROVAL enum value from the / response property for the response status