Reconcile a created/processing row via DOKU transactions-status - PeridotID

Reconcile a created/processing row via DOKU transactions-status

curl --request POST \
  --url https://api.pid.peridotvault.com/v1/fiat/deposits/{id}/sync \
  --cookie pid_access=

const options = {method: 'POST', headers: {cookie: 'pid_access='}};

fetch('https://api.pid.peridotvault.com/v1/fiat/deposits/{id}/sync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pid.peridotvault.com/v1/fiat/deposits/{id}/sync"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("cookie", "pid_access=")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "kind": "<string>",
  "providerRef": "<string>",
  "providerStatus": "created",
  "grossIdr": "<string>",
  "currency": "IDR",
  "createdAt": "2023-11-07T05:31:56Z",
  "feeIdr": "<string>",
  "netIdr": "<string>",
  "paymentUrl": "<string>",
  "feeStatus": "<string>"
}

{
  "statusCode": 401,
  "message": "Unauthorized"
}

{
  "statusCode": 404,
  "message": "No Identity found"
}

POST

/

fiat

/

deposits

/

{id}

/

sync

Reconcile a created/processing row via DOKU transactions-status

curl --request POST \
  --url https://api.pid.peridotvault.com/v1/fiat/deposits/{id}/sync \
  --cookie pid_access=

const options = {method: 'POST', headers: {cookie: 'pid_access='}};

fetch('https://api.pid.peridotvault.com/v1/fiat/deposits/{id}/sync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pid.peridotvault.com/v1/fiat/deposits/{id}/sync"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("cookie", "pid_access=")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "kind": "<string>",
  "providerRef": "<string>",
  "providerStatus": "created",
  "grossIdr": "<string>",
  "currency": "IDR",
  "createdAt": "2023-11-07T05:31:56Z",
  "feeIdr": "<string>",
  "netIdr": "<string>",
  "paymentUrl": "<string>",
  "feeStatus": "<string>"
}

{
  "statusCode": 401,
  "message": "Unauthorized"
}

{
  "statusCode": 404,
  "message": "No Identity found"
}

Authorizations

pid_access

string

cookie

required

JWT access token set by /auth/google/callback or /auth/refresh

Path Parameters

id

string

required

Response

Transaction

id

string

required

kind

string

required

deposit | payout_bank | payout_wallet | transfer_internal | debit | debit_cancel | fee | points_issue | points_fee | points_clawback

providerRef

string

required

Idempotency key (partnerReferenceNo at DOKU)

providerStatus

enum<string>

required

Payment state (never settlement). Checkout deposits use success/expired/failed; legacy rows may carry settled meaning paid.

Available options:

created,

processing,

settled,

success,

expired,

failed,

cancelled,

refunded

grossIdr

string

required

Gross movement (Checkout deposit = customer-paid net + fee; transfer = requested gross, beneficiary gets gross minus fee)

currency

enum<string>

required

Available options:

IDR

createdAt

string<date-time>

required

feeIdr

string | null

Platform service fee quote, snapshotted at intent time (legacy fee rows remain for history)

netIdr

string | null

Net user effect (gross minus fee)

paymentUrl

string | null

DOKU-hosted payment page for unpaid Checkout deposits

feeStatus

string | null

Legacy fee-leg status ({ref}-FEE row), read-only