Virtual Account

Virtual Account

Full VA lifecycle: management (create/update/inquire/delete) and the transaction-side calls (inquiry, payment, status, intrabank variants, report).

resp, err := transfercredit.CreateVA(ctx, transport, hb, transfercredit.CreateVARequest{
	VirtualAccountName: "Jane Doe",
	TrxID: "...",
})
if err != nil {
	// errors.Is(err, snap.ErrBadRequest), snap.ErrUnauthorized, etc.
}

CreateVA

CreateVA calls the SNAP VA - Create VA endpoint (Service Code 27, path …/{version}/transfer-va/create-va). hb must already carry every field snap.HeaderBuilder needs except Body, which CreateVA sets itself so the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it — a fresh X-EXTERNAL-ID on retry risks creating a duplicate VA.

func CreateVA(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req CreateVARequest) (CreateVAResponse, error)

Request — CreateVARequest

CreateVARequest is the request body for API VA - Create VA (Service Code 27). VirtualAccountName and TrxID are mandatory per the Guides tab; unlike every other Virtual Account endpoint, the identity triple (PartnerServiceID, CustomerNo, VirtualAccountNo) is Optional here.

Response — CreateVAResponse

CreateVAResponse is the response body for API VA - Create VA.

UpdateVA

UpdateVA calls the SNAP VA - Update VA endpoint (Service Code 28, path …/{version}/transfer-va/update-va, HTTP PUT). hb must already carry every field snap.HeaderBuilder needs except Method and Body, which UpdateVA sets itself: Method to PUT (the method is fixed by this endpoint, not caller-configurable) and Body so the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it.

func UpdateVA(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req UpdateVARequest) (UpdateVAResponse, error)

Request — UpdateVARequest

UpdateVARequest is the request body for API VA - Update VA (Service Code 28). PartnerServiceID, CustomerNo, VirtualAccountNo, VirtualAccountName, and TrxID are mandatory per the Guides tab — unlike Create VA, the identity triple is Mandatory here.

Response — UpdateVAResponse

UpdateVAResponse is the response body for API VA - Update VA.

UpdateStatusVA

UpdateStatusVA calls the SNAP VA - Update Status VA endpoint (Service Code 29, path …/{version}/transfer-va/update-status, HTTP PUT). hb must already carry every field snap.HeaderBuilder needs except Method and Body, which UpdateStatusVA sets itself: Method to PUT (the method is fixed by this endpoint, not caller-configurable) and Body so the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it.

func UpdateStatusVA(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req UpdateStatusVARequest) (UpdateStatusVAResponse, error)

Request — UpdateStatusVARequest

UpdateStatusVARequest is the request body for API VA - Update Status VA (Service Code 29). PartnerServiceID, CustomerNo, VirtualAccountNo, TrxID, and PaidStatus are mandatory per the Guides tab. PaidStatus values are “Y”/“N” per the research doc.

Response — UpdateStatusVAResponse

UpdateStatusVAResponse is the response body for API VA - Update Status VA.

InquiryVA

InquiryVA calls the SNAP VA - Inquiry VA endpoint (Service Code 30, path …/{version}/transfer-va/inquiry-va). hb must already carry every field snap.HeaderBuilder needs except Body, which InquiryVA sets itself so the exact marshaled bytes are used for both signing and the wire body.

func InquiryVA(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req InquiryVARequest) (InquiryVAResponse, error)

Request — InquiryVARequest

InquiryVARequest is the request body for API VA - Inquiry VA (Service Code 30). PartnerServiceID, CustomerNo, VirtualAccountNo, and TrxID are mandatory per the Guides tab.

Response — InquiryVAResponse

InquiryVAResponse is the response body for API VA - Inquiry VA.

DeleteVA

DeleteVA calls the SNAP VA - Delete VA endpoint (Service Code 31, path …/{version}/transfer-va/delete-va, HTTP DELETE). hb must already carry every field snap.HeaderBuilder needs except Method and Body, which DeleteVA sets itself: Method to DELETE (the method is fixed by this endpoint, not caller-configurable) and Body, since this DELETE ships a JSON request body rather than using path parameters — the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it.

func DeleteVA(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req DeleteVARequest) (DeleteVAResponse, error)

Request — DeleteVARequest

DeleteVARequest is the request body for API VA - Delete VA (Service Code 31). PartnerServiceID, CustomerNo, and VirtualAccountNo are mandatory per the Guides tab; TrxID is Optional.

Response — DeleteVAResponse

DeleteVAResponse is the response body for API VA - Delete VA.

VAInquiry

VAInquiry calls the SNAP VA - VA Inquiry endpoint (Service Code 24, path …/{version}/transfer-va/inquiry). hb must already carry every field snap.HeaderBuilder needs except Body, which VAInquiry sets itself so the exact marshaled bytes are used for both signing and the wire body.

func VAInquiry(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VAInquiryRequest) (VAInquiryResponse, error)

Request — VAInquiryRequest

VAInquiryRequest is the request body for API VA - VA Inquiry (Service Code 24). partnerServiceId, customerNo, virtualAccountNo, and inquiryRequestId are Mandatory. customerNo is json.RawMessage because a sibling endpoint’s worked example shows it as a bare JSON number, not a quoted string — supply a complete JSON value (e.g. json.RawMessage(\“98765”`)orjson.RawMessage(`98765`)`), not a bare Go string.

Response — VAInquiryResponse

VAInquiryResponse is the response body for API VA - VA Inquiry.

VAPayment

VAPayment calls the SNAP VA - VA Payment endpoint (Service Code 25, path …/{version}/transfer-va/payment, HTTP POST — no method override). hb must already carry every field snap.HeaderBuilder needs except Body, which VAPayment sets itself so the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it.

func VAPayment(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VAPaymentRequest) (VAPaymentResponse, error)

Request — VAPaymentRequest

VAPaymentRequest is the request body for API VA - VA Payment (Service Code 25). partnerServiceId, customerNo, virtualAccountNo, paymentRequestId, and paidAmount are Mandatory. trxId is Conditional — required if the VA was created via CreateVA. customerNo, channelCode, and paymentType are json.RawMessage since the standard’s worked examples show them as bare numbers rather than quoted strings.

Response — VAPaymentResponse

VAPaymentResponse is the response body for API VA - VA Payment.

VAInquiryStatus

VAInquiryStatus calls the SNAP VA - VA Inquiry Status endpoint (Service Code 26, path …/{version}/transfer-va/status). hb must already carry every field snap.HeaderBuilder needs except Body, which VAInquiryStatus sets itself so the exact marshaled bytes are used for both signing and the wire body.

func VAInquiryStatus(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VAInquiryStatusRequest) (VAInquiryStatusResponse, error)

Request — VAInquiryStatusRequest

VAInquiryStatusRequest is the request body for API VA - VA Inquiry Status (Service Code 26). partnerServiceId, customerNo, and virtualAccountNo (the identity triple) are Mandatory; inquiryRequestId and paymentRequestId are Optional/Conditional. This package always decodes the response as a single object, per the standard’s own type declaration.

Response — VAInquiryStatusResponse

VAInquiryStatusResponse is the response body for API VA - VA Inquiry Status.

VAInquiryPaymentIntrabank

VAInquiryPaymentIntrabank calls the SNAP VA - Inquiry Payment Intrabank endpoint (Service Code 32, path …/{version}/transfer-va/inquiry-intrabank). hb must already carry every field snap.HeaderBuilder needs except Body, which VAInquiryPaymentIntrabank sets itself so the exact marshaled bytes are used for both signing and the wire body.

func VAInquiryPaymentIntrabank(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VAInquiryPaymentIntrabankRequest) (VAInquiryPaymentIntrabankResponse, error)

Request — VAInquiryPaymentIntrabankRequest

VAInquiryPaymentIntrabankRequest is the request body for API VA - Inquiry Payment Intrabank (Service Code 32). partnerServiceId, customerNo, and virtualAccountNo (the identity triple) are Mandatory. customerNo is json.RawMessage since the standard’s worked example for this endpoint shows it as a bare JSON number.

Response — VAInquiryPaymentIntrabankResponse

VAInquiryPaymentIntrabankResponse is the response body for API VA - Inquiry Payment Intrabank.

VAPaymentIntrabank

VAPaymentIntrabank calls the SNAP VA - Payment Intrabank endpoint (Service Code 33, path …/{version}/transfer-va/payment-intrabank, HTTP POST — no method override). hb must already carry every field snap.HeaderBuilder needs except Body, which VAPaymentIntrabank sets itself so the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it.

func VAPaymentIntrabank(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VAPaymentIntrabankRequest) (VAPaymentIntrabankResponse, error)

Request — VAPaymentIntrabankRequest

VAPaymentIntrabankRequest is the request body for API VA - Payment Intrabank (Service Code 33). partnerServiceId, customerNo, virtualAccountNo, partnerReferenceNo, and paidAmount are Mandatory. customerNo and referenceNo are json.RawMessage since the standard’s worked examples show both as bare numbers, even though referenceNo appears quoted in the response. paymentStatus is a free-text status string, not the package’s usual 2-digit transactionStatus code.

Response — VAPaymentIntrabankResponse

VAPaymentIntrabankResponse is the response body for API VA - Payment Intrabank.

VANotifyPaymentIntrabank

VANotifyPaymentIntrabank calls the SNAP VA - Notify Payment Intrabank endpoint (Service Code 34, path …/{version}/transfer-va/notify-payment-intrabank, HTTP POST — no method override). hb must already carry every field snap.HeaderBuilder needs except Body, which VANotifyPaymentIntrabank sets itself so the exact marshaled bytes are used for both signing and the wire body.

This operation is not idempotent and this package does not retry. Callers that retry a failed or timed-out call should reuse the same X-EXTERNAL-ID, since the server’s own duplicate-detection keys on it.

func VANotifyPaymentIntrabank(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VANotifyPaymentIntrabankRequest) (VANotifyPaymentIntrabankResponse, error)

Request — VANotifyPaymentIntrabankRequest

VANotifyPaymentIntrabankRequest is the request body for API VA - Notify Payment Intrabank (Service Code 34). Unlike the RTGS/SKNBI/Interbank-Bulk notifications, this one is outbound — your code calls it, the PJP receives it — so it’s a normal calling function, not an inbound-only struct. customerNo is json.RawMessage since the standard’s worked example shows it as a bare number.

Response — VANotifyPaymentIntrabankResponse

VANotifyPaymentIntrabankResponse is the response body for API VA - Notify Payment Intrabank.

VAGetReport

VAGetReport calls the SNAP VA - Get Report endpoint (Service Code 35, path …/{version}/transfer-va/report). hb must already carry every field snap.HeaderBuilder needs except Method and Body: VAGetReport sets Method to POST itself (the standard documents this endpoint inconsistently as both GET and POST-with-body; this package always uses POST) and Body, so the exact marshaled bytes are used for both signing and the wire body.

A report covering a wide date range can return an unbounded number of array entries; the shared transport layer caps every response body at 10 MiB (see transport.go), so callers pulling large reports should page by narrower date/time ranges rather than one unbounded call.

func VAGetReport(ctx context.Context, t *snap.Transport, hb snap.HeaderBuilder, req VAGetReportRequest) (VAGetReportResponse, error)

Request — VAGetReportRequest

VAGetReportRequest is the request body for API VA - Get Report (Service Code 35). partnerServiceId is the only Mandatory field; it’s json.RawMessage here because the standard documents it as a Number for this endpoint specifically, unlike every other VA endpoint where it’s a String.

Response — VAGetReportResponse

VAGetReportResponse is the response body for API VA - Get Report — the only VA response in this package whose data field is an array rather than a single object.