Direct Debit

Direct Debit

Pembayaran direct-debit standar, notifikasi masuknya, serta status/batal/refund.

resp, err := transferdebit.DirectDebitPayment(ctx, transport, hb, transferdebit.DirectDebitPaymentRequest{
	PartnerReferenceNo: "2020102900000000000001",
})
if err != nil {
	// errors.Is(err, snap.ErrBadRequest), snap.ErrUnauthorized, etc.
}

DirectDebitPayment

DirectDebitPayment memanggil endpoint SNAP Direct Debit Payment (Service Code 54, HTTP POST). Isi hb dengan semua field kecuali Body — DirectDebitPayment melakukan marshal request itu sendiri dan memakai byte yang sama persis untuk signing maupun body di wire.

Operasi ini tidak idempotent dan package ini tidak melakukan retry. Bila memanggil ulang setelah gagal atau timeout, gunakan X-EXTERNAL-ID yang sama, karena deteksi duplikat di server mengacu pada header itu.

func DirectDebitPayment(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req DirectDebitPaymentRequest) (DirectDebitPaymentResponse, error)

Request — DirectDebitPaymentRequest

DirectDebitPaymentRequest adalah request body untuk Direct Debit Payment. partnerReferenceNo satu-satunya field Wajib.

Response — DirectDebitPaymentResponse

DirectDebitPaymentResponse adalah response body untuk Direct Debit Payment. referenceNo bersifat Kondisional — hanya muncul saat berhasil.

Direct Debit Payment Notification

Diterima — DirectDebitPaymentNotificationRequest

DirectDebitPaymentNotificationRequest adalah request body untuk Direct Debit Payment Notification (Service Code 56) — callback settlement yang diterima PJP, bukan panggilan yang dilakukan package ini. Buat HTTP handler Anda sendiri untuk path ini, autentikasi panggilan masuknya dengan ServerVerifier.VerifyTransactionRequest, lalu json.Unmarshal body ke tipe ini.

originalReferenceNo dan latestTransactionStatus bersifat Wajib; field lainnya Opsional.

Handler Anda membalas dengan — DirectDebitPaymentNotificationResponse

DirectDebitPaymentNotificationResponse punya satu field di luar envelope, approvalCode, dan sifatnya Opsional.

DirectDebitPaymentStatus

DirectDebitPaymentStatus memanggil endpoint SNAP Direct Debit Payment Status (Service Code 55, HTTP POST) untuk mengecek status pembayaran sebelumnya. Isi hb dengan semua field kecuali Body — DirectDebitPaymentStatus melakukan marshal request itu sendiri. Ini pencarian read-only, aman untuk diulang kapan saja.

func DirectDebitPaymentStatus(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req DirectDebitPaymentStatusRequest) (DirectDebitPaymentStatusResponse, error)

Request — DirectDebitPaymentStatusRequest

DirectDebitPaymentStatusRequest adalah request body untuk Direct Debit Payment Status. serviceCode satu-satunya field Wajib — pasangkan dengan reference apa pun yang Anda punya.

Response — DirectDebitPaymentStatusResponse

DirectDebitPaymentStatusResponse adalah response body untuk Direct Debit Payment Status. latestTransactionStatus satu-satunya field Wajib di luar envelope.

DirectDebitPaymentCancel

DirectDebitPaymentCancel memanggil endpoint SNAP Direct Debit Payment Cancel (Service Code 57, HTTP POST). Isi hb dengan semua field kecuali Body — DirectDebitPaymentCancel melakukan marshal request itu sendiri.

Operasi ini tidak idempotent dan package ini tidak melakukan retry. Bila memanggil ulang setelah gagal atau timeout, gunakan X-EXTERNAL-ID yang sama, karena deteksi duplikat di server mengacu pada header itu.

func DirectDebitPaymentCancel(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req DirectDebitPaymentCancelRequest) (DirectDebitPaymentCancelResponse, error)

Request — DirectDebitPaymentCancelRequest

DirectDebitPaymentCancelRequest adalah request body untuk Direct Debit Payment Cancel. originalPartnerReferenceNo satu-satunya field Wajib.

Response — DirectDebitPaymentCancelResponse

DirectDebitPaymentCancelResponse adalah response body untuk Direct Debit Payment Cancel. originalReferenceNo dan cancelTime bersifat Kondisional — hanya muncul saat berhasil.

DirectDebitPaymentRefund

DirectDebitPaymentRefund memanggil endpoint SNAP Direct Debit Payment Refund (Service Code 58, HTTP POST). Isi hb dengan semua field kecuali Body — DirectDebitPaymentRefund melakukan marshal request itu sendiri.

Operasi ini tidak idempotent dan package ini tidak melakukan retry. Bila memanggil ulang setelah gagal atau timeout, gunakan X-EXTERNAL-ID yang sama, karena deteksi duplikat di server mengacu pada header itu.

func DirectDebitPaymentRefund(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req DirectDebitPaymentRefundRequest) (DirectDebitPaymentRefundResponse, error)

Request — DirectDebitPaymentRefundRequest

DirectDebitPaymentRefundRequest adalah request body untuk Direct Debit Payment Refund. originalPartnerReferenceNo dan partnerRefundNo bersifat Wajib.

Response — DirectDebitPaymentRefundResponse

DirectDebitPaymentRefundResponse adalah response body untuk Direct Debit Payment Refund. originalReferenceNo bersifat Kondisional — hanya muncul saat berhasil. refundNo, partnerRefundNo, dan refundTime bersifat Wajib.