Bind a named account
curl --request POST \
--url https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"partner": "safehaven",
"accountNumber": "0123456789"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({partner: 'safehaven', accountNumber: '0123456789'})
};
fetch('https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind"
payload = {
"partner": "safehaven",
"accountNumber": "0123456789"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind"
payload := strings.NewReader("{\n \"partner\": \"safehaven\",\n \"accountNumber\": \"0123456789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "<string>",
"accountId": "<string>",
"accountLabel": "<string>",
"partner": "<string>",
"partnerName": "<string>",
"accountNumber": "<string>",
"bankCode": "<string>",
"accountName": "<string>",
"currency": "<string>",
"status": "PENDING",
"mandateRef": "<string>",
"partnerRef": "<string>",
"failureReason": "<string>",
"pendingApprovalId": "<string>",
"issuedAt": "2023-11-07T05:31:56Z",
"closedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}Named accounts
Bind a named account
The tenant supplies a number it opened with its partner. In FULL mode PanoQore first checks with the partner that the number is an open account under the tenant’s credentials, and takes the name from it.
Scope: named:write.
POST
/
v1
/
accounts
/
{account_id}
/
named-accounts:bind
Bind a named account
curl --request POST \
--url https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"partner": "safehaven",
"accountNumber": "0123456789"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({partner: 'safehaven', accountNumber: '0123456789'})
};
fetch('https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind"
payload = {
"partner": "safehaven",
"accountNumber": "0123456789"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.panoqore.example/v1/accounts/{account_id}/named-accounts:bind"
payload := strings.NewReader("{\n \"partner\": \"safehaven\",\n \"accountNumber\": \"0123456789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "<string>",
"accountId": "<string>",
"accountLabel": "<string>",
"partner": "<string>",
"partnerName": "<string>",
"accountNumber": "<string>",
"bankCode": "<string>",
"accountName": "<string>",
"currency": "<string>",
"status": "PENDING",
"mandateRef": "<string>",
"partnerRef": "<string>",
"failureReason": "<string>",
"pendingApprovalId": "<string>",
"issuedAt": "2023-11-07T05:31:56Z",
"closedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "<string>",
"details": {},
"request_id": "<string>"
}
}Authorizations
An API key, pk_live_… or pk_test_….
Headers
Your unique key for this write, at most 255 characters. A retry with the same key and body gets the first answer back.
Maximum string length:
255Path Parameters
The account id.
Body
application/json
Response
OK
nam_…
the bound ledger account's name
safehaven | nomba | …
PENDING: asked the partner, no number yet
Available options:
PENDING, ACTIVE, FROZEN, CLOSED, FAILED